CAPABILITY (Mixer Command)

The CAPABILITY command requests information about the features and supported functions of the audio amplifier mixer device.

Syntax

CAPABILITY ─── object ───┬─ CAN EJECT ───────────────┬───┬──────────┬───┤
                         ├─ CAN LOCK EJECT ──────────┤   ├─ WAIT    ─┤
                         ├─ CAN PLAY ────────────────┤   └─ NOTIFY  ─┘
                         ├─ CAN PROCESS INTERNAL ────┤
                         ├─ CAN RECORD ──────────────┤
                         ├─ CAN SAVE ────────────────┤
                         ├─ CAN STREAM ──────────────┤
                         ├─ CAN SET VOLUME ──────────┤
                         ├─ COMPOUND DEVICE ─────────┤
                         ├─ DEVICE TYPE ─────────────┤
                         ├─ HAS AUDIO ───────────────┤
                         ├─ HAS VIDEO ───────────────┤
                         ├─ MESSAGE command ─────────┤
                         ├─ PREROLL TIME ────────────┤
                         ├─ PREROLL TYPE ────────────┤
                         ├─ USES FILES ──────────────┤
                         └─ EXTENDED MIXER connector ─┬─ SUPPORTS AUTO LEVEL CONTROL ─┤
                                                      ├─ SUPPORTS BALANCE ────────────┤
                                                      ├─ SUPPORTS BASS ───────────────┤
                                                      ├─ SUPPORTS CHORUS ─────────────┤
                                                      ├─ SUPPORTS CROSSOVER ──────────┤
                                                      ├─ SUPPORTS CUSTOM1 ────────────┤
                                                      ├─ SUPPORTS CUSTOM2 ────────────┤
                                                      ├─ SUPPORTS CUSTOM3 ────────────┤
                                                      ├─ SUPPORTS GAIN ───────────────┤
                                                      ├─ SUPPORTS LOUDNESS ───────────┤
                                                      ├─ SUPPORTS MID ────────────────┤
                                                      ├─ SUPPORTS MONITOR ────────────┤
                                                      ├─ SUPPORTS MUTE ───────────────┤
                                                      ├─ SUPPORTS PITCH ──────────────┤
                                                      ├─ SUPPORTS REVERB ─────────────┤
                                                      ├─ SUPPORTS STEREO ENHANCE ─────┤
                                                      ├─ SUPPORTS TREBLE ─────────────┤
                                                      └─ SUPPORTS VOLUME ─────────────┘

Keywords

object

Object associated with this media control interface command. The object can be one of the following:

Device type
Device name
Filename
Alias

CAN EJECT: Returns FALSE.

CAN LOCK EJECT: Returns FALSE.

CAN PLAY: Returns FALSE.

CAN PROCESS INTERNAL: Returns FALSE.

CAN RECORD: Returns FALSE.

CAN SAVE: Returns FALSE.

CAN STREAM: Returns FALSE.

CAN SET VOLUME: Returns TRUE.

COMPOUND DEVICE: Returns FALSE.

DEVICE TYPE: Returns Ampmix.

HAS AUDIO: Returns TRUE.

HAS VIDEO: Returns FALSE.

MESSAGE command: Returns TRUE if the device supports the command specified by command. The command can be any of the string commands such as OPEN, PLAY, etc.

PREROLL TIME: Returns 0, indicating the preroll time is not bounded.

PREROLL TYPE: Returns NONE.

USES FILES: Returns FALSE.

EXTENDED MIXER CONNECTOR type: Indicates that a mixer format will be queried. The type specified must be a valid connector type. If the EXTENDED MIXER keywords are specified, a SUPPORTS keyword must also be specified.

SUPPORTS [Feature]: Indicates whether the specified connector supports a particular setting (e.g., VOLUME, MUTE, BALANCE, BASS, TREBLE, etc.).

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.

NOTIFY: The command is executed asynchronously. When the action is complete, an MM_MCINOTIFY message is sent to the application window procedure.

Example

capability ampmix01 can record wait