SoundGetWaveVolume

Retrieves the wave output volume of a sound device.

SoundGetWaveVolume, OutputVar , DeviceNumber

Parameters

OutputVar

The name of the variable in which to store the retrieved volume level, which is a floating point number between 0 and 100 inclusive. The variable will be made blank if there was a problem retrieving the volume. The format of the floating point number, such as its decimal places, is determined by SetFormat.

DeviceNumber

If this parameter is omitted, it defaults to 1 (the first sound device), which is usually the system's default device for recording and playback. Specify a number higher than 1 to operate upon a different sound device.

Error Handling

[v1.1.04+]: This command is able to throw an exception on failure. For more information, see Runtime Errors.

ErrorLevel is set to 1 if there was a problem or 0 otherwise.

Remarks

The current wave output volume level can be set via SoundSetWaveVolume. Settings such as Master Volume, Synth, Microphone, Mute, Treble, and Bass can be set and retrieved using SoundSet and SoundGet.

[v1.1.10+]: On Windows Vista and later, this command is equivalent to SoundGet with ComponentType set to Wave and ControlType set to Volume.

SoundSetWaveVolume, SoundSet, SoundGet, SoundPlay

Examples

Retrieves and reports the current wave output volume.

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