SoundSetWaveVolume

改变音频设备的波形输出音量。

SoundSetWaveVolume, Percent [, DeviceNumber]

参数

Percent

介于 -100 和 100 (包含的) 之间的百分数 (它可以为浮点数或 表达式). 如果这个数字以加号或减号开头, 则将 当前音量级别 往上或往下调指示的数量. 否则, 音量将被明确地设置为 Percent 表示的级别.

DeviceNumber

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

ErrorLevel

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

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

备注

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

Windows Vista 及更高版本(v1.1.10+):此命令相当于 ComponentType 参数被设为 WaveControlType 被设为 VolumeSoundSet 命令。这两者都会尝试维持原有的声道平衡。

Windows 2000/XP/2003:与 SoundSet 不同,此命令在改变音量级别时会尝试维持原有的声道平衡(例如左和右)。

相关

SoundGetWaveVolume, SoundSet, SoundGet, SoundPlay

示例

SoundSetWaveVolume, 50  ; 将波形音量设为一半.
SoundSetWaveVolume, -10  ; 将当前级别减小 10 (例如 80 会变成 70).
SoundSetWaveVolume, +20  ; 将当前级别增加 20.