DEFAULTCONNECTION

The DEFAULTCONNECTION command makes, breaks, or queries a default connection.

Syntax

DEFAULTCONNECTION ---- object ----+-----------------------------------------------------------------------------------+--+----------+--
                                 |  MAKE TO devicename --+-- TYPE connector_type --+--+-- TOTYPE connector_type --+--+ |  |  WAIT    |
                                 |                      |                         |  |  TONUMBER connector_number  |  | +----------+
                                 |                      +-- NUMBER connector_number  |  +---------------------------+  | |  NOTIFY  |
                                 |                                                  |                                 | +----------+
                                 +-- BREAK -- TYPE connector_type ------------------+
                                 +-- QUERY ----------------------------------------+

Keywords

object

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

• Device type
• Device name
• Filename
• Alias

MAKE TO devicename

Establish a connection. The *devicename* is necessary for connection to be established. Use of the **MAKE TO** keyword also requires the **TONUMBER** and/or **TOTYPE** keyword.

TYPE connector_type

Indicates the connector type.

NUMBER connector_number

Indicates the connector number to which the action applies. 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.

TOTYPE connector_type

Indicates the type of connector on the target device.

TONUMBER connector_number

Indicates the connector number on the target device during a **MAKE** action. If this item is omitted, the first connector is assumed. If the **TOTYPE** keyword is included, then the connector number is interpreted as a relative offset within the specified connector type.

BREAK

Delete a connection. If the **BREAK** keyword is specified, the **TYPE** keyword is also required.

QUERY

Query a connection. Returns the *devicename*, *connector_type*, and *connector_number*.

WAIT

The command is executed synchronously. The function waits until the requested action is complete before returning to the application. The **WAIT** flag must be specified to receive return string information.

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.

Remarks

The DEFAULTCONNECTION command makes, breaks, or queries a default connection.

Example Code

defaultconnection digitalvideo query wait

The command above returns "ampmix01 ampmix 1".