CONNECTOR (Mixer Command)

The CONNECTOR command enables, disables, or queries the status of connectors on a device.

Syntax

CONNECTOR ─── object ───┬─ ENABLE ──┬───┬──────────────────────────┬───┬──────────┬───┤
                        ├─ DISABLE ─┤   ├─ NUMBER connector_number ─┤   ├─ WAIT    ─┤
                        └─ QUERY ───┘   └─ TYPE connector_type ────┘   └─ NOTIFY  ─┘

Keywords

object

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

Device type
Device name
Filename
Alias

ENABLE: Enables information flow through the indicated connector. Use of this option requires that the NUMBER or TYPE keywords, or both also be specified.

DISABLE: Disables information flow through the indicated connector. Use of this option requires that the NUMBER or TYPE keywords, or both also be specified.

QUERY: Queries the status of the indicated connector. The return value will be either TRUE or FALSE to indicate enabled or disabled respectively. Use of this option requires that the NUMBER or TYPE keywords, or both also be specified.

NUMBER connector_number: Indicates the connector number on which to perform the requested action. If this item is omitted, then the first connector is assumed. If the TYPE keyword is included, then the connector number is interpreted as a relative offset within the specified connector type.

TYPE connector_type

Indicates the type of connector to which the requested action applies. The following connector types are supported by this device:

amp stream: Digital input or output for the audio amplifier/mixer. This connector is always enabled.
line in: The line input connector. This connector is usually attached to the line out connector of another device such as a tape player or other audio input source.
microphone: The microphone connector. This connector is usually attached to a microphone for live recording or voice annotation.
line out: The line output connector. This connector is usually attached to the line in connector of another device such as a tape recorder or other audio device.
speakers: The speakers connector. This connector is usually attached to a pair of external or internal speakers.
headphones: The headphones connector. This connector is usually attached to a pair of headphones.

WAIT: The command is executed synchronously. The function waits until the requested action is complete before returning to the application.

NOTIFY: The command is executed asynchronously, allowing control to be returned immediately to the application. When the requested action is complete, an MM_MCINOTIFY message is sent to the application window procedure.

Example

connector wave query type amp stream wait