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_QUERY_CONNECTION
Indicates
that the media driver must return the device ID of the connected device
in the usToDeviceID field. The MCI_CONNECTOR_TYPE and MCI_CONNECTOR_INDEX
flags specify parameters that identify the desired connector. Once the
device ID is obtained, an application can send messages directly to the
connected device to obtain advanced functionality not directly provided
by the original device. If no connection exists, MCIERR_NO_CONNECTION is
returned.
MCI_CONNECTOR_TYPE
Indicates
that the ulConnectorType field specifies a connector type for the
primary device. 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.
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_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 can be used to access 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.
MCI_CONNECTOR_ALIAS
Indicates that the pszAlias field contains
an alias for the device instance connected to the specified connector. If
the alias already exists for another device, the error MCIERR_DUPLICATE_ALIAS
is returned. If the connected to device already has an alias, the error
MCIERR_CANNOT_ADD_ALIAS is returned. The primary purpose of this function
is to permit access to connected devices through the string interface.