STATUS (Mixer Command)

The STATUS command obtains status information for the audio amplifier mixer device.

Syntax

STATUS ─── object ──┬───────────────────────────────┬───┬──────────┬───┤
                    ├─ AUDIO CHANNEL value ─────────┤   ├─ WAIT    ─┤
                    ├─ BASS ────────────────────────┤   └─ NOTIFY  ─┘
                    ├─ BALANCE ─────────────────────┤
                    ├─ CURRENT TRACK ───────────────┤
                    ├─ GAIN ────────────────────────┤
                    ├─ LENGTH ──────────────────────┤
                    ├─ LENGTH TRACK number ─────────┤
                    ├─ MONITOR ─────────────────────┤
                    ├─ NUMBER OF TRACKS ────────────┤
                    ├─ PITCH ───────────────────────┤
                    ├─ POSITION ────────────────────┤
                    ├─ POSITION IN TRACK ───────────┤
                    ├─ POSITION TRACK number ───────┤
                    ├─ SPEED FORMAT ────────────────┤
                    ├─ TIME FORMAT ─────────────────┤
                    ├─ TREBLE ──────────────────────┤
                    ├─ VOLUME ──────────────────────┤
                    └─ CONNECTOR type ──┬─ AUTO LEVEL CONTROL ─┤
                                        ├─ BALANCE ────────────┤
                                        ├─ BASS ───────────────┤
                                        ├─ CHORUS ─────────────┤
                                        ├─ CROSSOVER ──────────┤
                                        ├─ CUSTOM1 ────────────┤
                                        ├─ CUSTOM2 ────────────┤
                                        ├─ CUSTOM3 ────────────┤
                                        ├─ GAIN ───────────────┤
                                        ├─ LOUDNESS ───────────┤
                                        ├─ MID ────────────────┤
                                        ├─ MONITOR ────────────┤
                                        ├─ MUTE ───────────────┤
                                        ├─ PITCH ──────────────┤
                                        ├─ REVERB ─────────────┤
                                        ├─ TREBLE ─────────────┤
                                        └─ VOLUME ─────────────┘

Keywords

object: Object associated with this media control interface command (Device type, name, filename, or alias).

AUDIO CHANNEL value: Must specify **all**, **left**, **right**, or a **number**. Returns TRUE or FALSE to indicate if the channel is enabled.

BASS | TREBLE | GAIN | PITCH: Returns the current setting as a percentage (0-100) of the maximum achievable effect.

BALANCE: Returns the current balance setting (0 for full left, 100 for full right).

VOLUME: Returns the current volume as a string in the format "left:right" (e.g., "80:80").

MONITOR: Returns TRUE or FALSE indicating if the device is monitoring input during recording.

CURRENT TRACK: The amplifier mixer device always returns 1.

CONNECTOR type: Specifies the hardware connector (e.g., speakers, line in) for which status is requested.; Sub-keywords (VOLUME, MUTE, GAIN, etc.) return the specific setting for that connector.

WAIT: Executes synchronously. **Note:** This keyword must be specified to receive return string information.

NOTIFY: Executes asynchronously and sends an MM_MCINOTIFY message upon completion.

Unsupported Keywords

The following keywords are accepted by the syntax but are **not supported** by the amplifier mixer device:

LENGTH
LENGTH TRACK number
NUMBER OF TRACKS
POSITION
POSITION IN TRACK
POSITION TRACK number
SPEED FORMAT
TIME FORMAT

Purpose

The STATUS command is used to query the current state, levels, and configuration of the amplifier mixer and its individual connectors.

Example

status ampmix01 balance wait