Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

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)

See also

MCI
MCI Functions
Command Messages

 

 

Community Additions

Show:
© 2014 Microsoft