mciSendCommand function
The mciSendCommand function sends a command message to the specified MCI device.
Syntax
MCIERROR mciSendCommand(
MCIDEVICEID IDDevice,
UINT uMsg,
DWORD_PTR fdwCommand,
DWORD_PTR 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 a list, see Multimedia Commands.fdwCommand
Flags for the command message.dwParam
Pointer to a structure that contains parameters for the command message.
Return value
Returns zero if successful or an error otherwise. The low-order word of the returned DWORD 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 MCIERR Return Values.
To retrieve a text description of 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 MCIERR Return Values.
Use MCI_OPEN to obtain the device identifier specified by the IDDevice parameter.
Requirements
Minimum supported client |
Windows 2000 Professional [desktop apps only] |
Minimum supported server |
Windows 2000 Server [desktop apps only] |
Header |
Mmsystem.h (include Windows.h) |
Library |
Winmm.lib |
DLL |
Winmm.dll |
Unicode and ANSI names |
mciSendCommandW (Unicode) and mciSendCommandA (ANSI) |