This message is used to enable, disable or query the status of a particular connector for a device instance. The connector can be specified either absolutely or as a relative offset within a specified connector type.

ulParam1 (ULONG)

This parameter can contain any of the following flags:

MCI_NOTIFY

A notification message will be posted to the window specified in the hwndCallback parameter of the data structure pointed to by the pParam2 parameter. The notification will be posted when the action indicated by this message is completed or when an error occurs.
MCI_WAIT
Control is not to be returned until the action indicated by this message is completed or an error occurs.
MCI_ENABLE_CONNECTOR
Enables input or output through the specified connector.
MCI_DISABLE_CONNECTOR
Disables input or output through the specified connector.
MCI_QUERY_CONNECTOR_STATUS
Queries the status of the specified connector and returns the result in the ulReturn field of the parameter data structure pointed to by pParam2. The possible states are enabled or disabled.
MCI_CONNECTOR_TYPE
Indicates that the connector type (ulConnectorType field) for the primary device is to be used for the query. When this flag is used, the ulConnectorIndex field is interpreted as a relative index rather than an absolute index. The following connector types are currently defined:

MCI_MIDI_STREAM_CONNECTOR

Digital input or output for the sequencer device. This data typically is streamed to an amplifier mixer device.
MCI_CD_STREAM_CONNECTOR
Digital output for a CD audio device capable of reading the data directly off a disc. The data typically is streamed to an amplifier mixer device.
MCI_WAVE_STREAM_CONNECTOR
Digital input or output for the waveform audio device. The data typically is streamed to an amplifier mixer device.

This connector type is not supported by the digital video MCD.

MCI_XA_STREAM_CONNECTOR
Digital output for the CD XA device. The data typically is streamed to an amplifier mixer device.
MCI_AMP_STREAM_CONNECTOR
Digital input or output for an amplifier mixer device.
MCI_HEADPHONES_CONNECTOR
The connector on the device that is typically used to attach headphones to the device.
MCI_SPEAKERS_CONNECTOR
The connector on the device that is typically used to attach speakers to the device.
MCI_MICROPHONE_CONNECTOR
The connector on the device that is typically used to attach a microphone to the device.
MCI_LINE_IN_CONNECTOR
The connector on the device that is typically used to provide line level input to the device.
MCI_LINE_OUT_CONNECTOR
The connector on the device that is typically used to provide line level output from the device.
MCI_AUDIO_IN_CONNECTOR
The connector on the device that is typically used to provide audio input to the device.
MCI_AUDIO_OUT_CONNECTOR
The connector on the device that is typically used to provide audio output from the device.
MCI_VIDEO_IN_CONNECTOR
The connector on the device that is typically used to provide video input to the device.
MCI_VIDEO_OUT_CONNECTOR
The connector on the device that is typically used to provide video output from the device.
MCI_UNIVERSAL_CONNECTOR
A connector on a device that does not fall into any of the other categories. This connector type can be used to access a device-dependent function. The manufacturer of the device should define the exact use of this connector.
MCI_CONNECTOR_INDEX
Indicates that the ulConnectorIndex field contains the connector index for the primary device. If this flag is not specified then an index of 1 is assumed.

pParam2 (PMCI_CONNECTOR_PARMS)

A pointer to the MCI_CONNECTOR_PARMS data structure.

rc (ULONG)

Return codes indicating success or type of failure:

MCIERR_SUCCESS

MMPM/2 command completed successfully.
MCIERR_OUT_OF_MEMORY
System out of memory.
MCIERR_INVALID_DEVICE_ID
Invalid device ID given.
MCIERR_MISSING_PARAMETER
Missing parameter for this command.
MCIERR_DRIVER
Internal MMPM/2 driver error.
MCIERR_INVALID_FLAG
Invalid flag specified for this command.
MCIERR_MISSING_FLAG
Flag missing for this MMPM/2 command.
MCIERR_FLAGS_NOT_COMPATIBLE
Flags not compatible.
MCIERR_INSTANCE_INACTIVE
Instance inactive.
MCIERR_INVALID_CONNECTOR_INDEX
Invalid connector index.
MCIERR_INVALID_CONNECTOR_TYPE
Invalid connector type given.
MCIERR_UNSUPPORTED_CONN_TYPE
Connector type is not supported by this device.
MCIERR_CANNOT_MODIFY_CONNECTOR
Cannot enable or disable this connector.

---

[Back] [Next]