mciSendCommand
The mciSendCommand
function sends a command message to the specified MCI device.
MCIERROR mciSendCommand(
|
MCIDEVICEID IDDevice, |
|
|
UINT uMsg, |
|
|
DWORD fdwCommand, |
|
|
DWORD dwParam |
|
|
); |
|
Parameters
IDDevice
Device
identifier of the MCI device that is to receive the command message. This
parameter is not used with the MCI_OPEN command message.
uMsg
Command
message. For information about command
messages, see Command Messages.
fdwCommand
Flags for the
command message.
dwParam
Address of a
structure that contains parameters for the command message.
Return Values
Returns zero
if successful or an error otherwise. The low-order word of the returned
doubleword value contains the error return value. If the error is
device-specific, the high-order word of the return value is the driver
identifier; otherwise, the high-order word is zero. For a list of possible
return values, see Constants: MCIERR Return Values.
To retrieve a
text description of mciSendCommand return values, pass the return value
to the mciGetErrorString function.
Remarks
Error values
that are returned when a device is being opened are listed with the MCI_OPEN
command message. In addition to the MCI_OPEN error return values,
this function can return the values listed in Constants: MCIERR Return
Values.
Use MCI_OPEN
to obtain the device identifier specified by the IDDevice parameter.
See Also