SoundGetMute

检索声音设备的静音设置.

Setting := SoundGetMute(Component, Device)

参数

Component

类型: 字符串或整数

如果为空或省略, 则检索主静音设置. 否则, 指定组件的显示名称和/或索引. 例如, 1, "Line in" 或 "Line in:2".

有关详情, 请参阅 Component (Sound 函数).

Device

类型: 字符串或整数

如果为空或省略, 则它默认为系统的默认回放设备(不一定是设备 1). 否则, 指定设备的显示名称和/或索引. 例如, 1, "Speakers", "Speakers:2" 或 "Speakers (Example HD Audio)".

有关详情, 请参阅 Device (Sound 函数).

返回值

类型: 整数(布尔值)

函数返回 0(false) 表示未静音, 或 1(true) 代表静音.

错误处理

如果无法找到设备或组件, 或组件不支持此控制类型, 则抛出 TargetError. 否则失败时, 抛出 OSError.

备注

要发现系统上安装的声音设备的功能 -- 比如名称和可用的组件 -- 请运行这个声卡分析脚本.

相关

Sound 函数

示例

master_mute := SoundGetMute()
if master_mute
    MsgBox "The default playback device is muted."
else
    MsgBox "The default playback device is not muted."

if SoundGetMute("Line In") = 0
    MsgBox "Line In pass-through is not muted."

if SoundGetMute( , "Microphone") = 0
    MsgBox "The microphone (recording) is not muted."