View source for MASTERAUDIO

{{DISPLAYTITLE:MASTERAUDIO}}
The MASTERAUDIO command sets the system master audio setting for all audio devices in the system. The **WAIT** flag must be specified to get string return information for queries.

This command is used by the OS/2 multimedia Volume Control application to control system-wide audio parameters based on user preference. Applications should take special care when using **MASTERAUDIO**, as it results in a system-wide change. Typically, applications control the volume only within an application.

==Syntax==
<PRE>
MASTERAUDIO --+-- VOLUME level ---------+--+----------+--
              |  QUERY VOLUME          |  |  WAIT    |
              |  QUERY HEADPHONES      |  +----------+
              +-- QUERY SPEAKERS -------+
</PRE>

==Keywords==
;VOLUME level
:Sets the system-wide master volume to the *level* specified as a percentage (0-100).

;QUERY VOLUME
:Returns the current application controlled master volume level (0-100 is returned).

;QUERY HEADPHONES
:Queries the system-wide headphone setting. **ON** or **OFF** is returned.

;QUERY SPEAKERS
:Queries the system-wide speaker setting. **ON** or **OFF** is returned.

;WAIT
:The command is executed synchronously. The function waits until the requested action is complete before returning to the application. The **WAIT** keyword must be specified to receive return string information.

==Remarks==
The **MASTERAUDIO** command sets the system master audio setting for all audio devices in the system. Applications should generally control volume only within their own context, as this command causes a system-wide change.

==Example Code==
<PRE>
masteraudio query volume wait
</PRE>

[[Category:MM System Commands]]