CONNECTORINFO

The CONNECTORINFO command returns information about the connectors on a device.

Syntax

CONNECTORINFO --- object ---+-------------------------------------------------+--+----------+--
                           |  ENUMERATE --+-- TYPE connector_type --+       |  |  WAIT    |
                           |             +-------------------------+       |  +----------+
                           +-- TYPEOF -- NUMBER connector_number ----------+  |  NOTIFY  |
                           +-- CAN CONNECT TO connector_type -- TYPE connector_type --+  +----------+

Keywords

object

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

• Device type
• Device name
• Filename
• Alias

ENUMERATE

Returns the number of connectors of the specified type. If no **TYPE** keyword is specified, then the total number of connectors for the device is returned.

TYPE connector_type

Indicates the type of connector to which the query applies. The connector types are defined for each device. See the **TYPE** keyword for CONNECTION for a list of supported connector types.

TYPEOF

Returns the connector type of the specified connector. Use of this option requires that the **NUMBER** keyword must also be specified.

NUMBER connector_number

Indicates the connector number to which this query applies.

CAN CONNECT TO connector_type

Returns true if this connector type is compatible with the connector type of the specified connector; that is, results in a valid connection. Use of this option requires that the **TYPE** keyword must also be specified.

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, 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 CONNECTORINFO command returns information about the connectors on a device.

Example Code

connectorinfo digitalvideo typeof number 1 wait

The command above returns "wave stream".