SoundGetVolume

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

Setting := SoundGetVolume(Component, Device)

参数

Component

类型: 字符串或整数

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

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

Device

类型: 字符串或整数

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

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

返回值

类型: 浮点数

函数返回 0.0 到 100.0 之间的浮点数.

错误处理

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

备注

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

相关

Sound 函数

示例

master_volume := SoundGetVolume()
MsgBox "Master volume is " master_volume " percent."

mic_volume := SoundGetVolume("Microphone")
MsgBox "Microphone listening volume is " mic_volume " percent."

mic_volume := SoundGetVolume( , "Microphone")
MsgBox "Microphone recording volume is " mic_volume " percent."