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

MASTERAUDIO --+-- VOLUME level ---------+--+----------+--
              |  QUERY VOLUME          |  |  WAIT    |
              |  QUERY HEADPHONES      |  +----------+
              +-- QUERY SPEAKERS -------+

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

masteraudio query volume wait