MCI_CONNECTORINFO Parameter - ulParam1
ulParam1 (ULONG)
The
parameter can contain any the following flags with the following exceptions:
The MCI_ENUMERATE_CONNECTORS, MCI_QUERY_CONNECTOR_TYPE, and MCI_QUERY_VALID_CONNECTION
flags are mutually exclusive. In addition, MCI_ENUMERATE_CONNECTORS and
MCI_CONNECTOR_INDEX are mutually exclusive, and the error MCIERR_FLAGS_NOT_COMPATIBLE
is returned if these flags are used together.
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_CONNECTOR_TYPE
This
flag indicates that the connector type (ulConnectorType field) for
the primary device is to be used for the query. When this flag is used
then the ulConnectorIndex field is used as a relative index rather
than an absolute index.
MCI_CONNECTOR_INDEX
This
flag indicates that the ulConnectorIndex field contains the connector
index for the primary device. If this flag is not specified, an index of
1 is assumed.
MCI_QUERY_CONNECTOR_TYPE
This
flag returns connector type in the ulReturn field. To specify the
connector to query, use the MCI_CONNECTOR_INDEX flag.
MCI_ENUMERATE_CONNECTORS
This flag returns the number of connectors for
the given device. If the MCI_CONNECTOR_TYPE flag is also specified, the
number of connectors for the specified type is returned. The value is returned
in the ulReturn field.
MCI_QUERY_VALID_CONNECTION
This flag determines if the specified connection
is possible. MCI_TRUE is returned if the connector types specified in the
ulConnectorType and ulToConnectorType fields are compatible,
resulting in a valid connection. Otherwise, MCI_FALSE is returned.
MCI_TO_CONNECTOR_TYPE
This flag specifies that the connector type (ulToConnectorType
field) for the primary device is to be used for the query. When this
flag is used, the ulConnectorIndex field is used as a relative index
rather than an absolute index.
[Back: MCI_CONNECTORINFO]
[Next: MCI_CONNECTORINFO Parameter - pParam2]