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".