SoundGetWaveVolume

获取音频设备的波形输出音量.

SoundGetWaveVolume, OutputVar [, DeviceNumber]

参数

OutputVar

用来保存获取的音量级别的变量名, 它是一个介于 0 和 100 (包含的) 之间的浮点数. 如果在获取音量时遇到问题, 则此变量会被置空. 浮点数的格式 (例如它的小数位数) 由 SetFormat 决定.

DeviceNumber

如果省略此参数, 则它默认为 1 (首个音频设备), 通常是系统默认的录制和播放设备. 可以通过指定大于 1 的数字来操作其他音频设备.

ErrorLevel

[v1.1.04+] 此命令失败时会抛出异常. 想了解更多信息, 请参阅 运行时错误.

如果遇到问题则 ErrorLevel 被置为 1, 否则为 0.

备注

使用 SoundSetWaveVolume 可以设置当前的波形输出音量级别. 其他设置 (例如主音量, 合成器, 麦克风, 静音, 高音和低音) 可以使用 SoundSet 和 SoundGet 进行设置和获取.

Windows Vista 及更高版本(v1.1.10+):此命令相当于 ComponentType 参数被设为 Wave 且 ControlType 被设为 Volume 的 SoundGet 命令.

相关

SoundSetWaveVolume, SoundSet, SoundGet, SoundPlay

示例

SoundGetWaveVolume, OutputVar
MsgBox, The current wave output volume level is %OutputVar%`%.