CONNECTOR (CD Audio Commands)

The CONNECTOR command enables, disables, or queries the status of connectors on a CD audio 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 (Device type, name, filename, or alias).

ENABLE

Enables information flow through the indicated connector. Requires the **NUMBER** or **TYPE** keyword.

DISABLE

Disables information flow through the indicated connector. Requires the **NUMBER** or **TYPE** keyword.

QUERY

Queries the status of the indicated connector. Returns "true" (enabled) or "false" (disabled). Requires the **NUMBER** or **TYPE** keyword.

NUMBER connector_number

Specifies the connector index. If omitted, the first connector is assumed. If used with **TYPE**, the number is relative to that specific type.

TYPE connector_type

Specifies the category of connector. Supported types for CD audio include:

**CD stream**: Digital output. If enabled (and supported by device capability), the CD device streams digital data to an associated amplifier/mixer.
**headphones**: The physical headphone jack connector on the CD device.

WAIT: Executes the command synchronously. The function waits until the action is complete before returning.
NOTIFY: Executes the command asynchronously and sends an MM_MCINOTIFY message upon completion.

Purpose

The CONNECTOR command is used to manage the routing of audio signals, such as turning on digital streaming to a mixer or controlling the headphone output path.

Example

open cdaudio alias cdaud shareable wait
connector cdaud enable type CD stream wait

*(Enables digital streaming for the device aliased as 'cdaud')*