mciGetDeviceID

The mciGetDeviceID function retrieves the device identifier corresponding to the name of an open device.

MCIDEVICEID mciGetDeviceID(
  LPCTSTR lpszDevice  
);
 

Parameters

lpszDevice

Address of a null-terminated string that specifies the device name or the alias name by which the device is known.

Return Values

Returns the device identifier assigned to the device when it was opened if successful. The identifier is used in the mciSendCommand function. If the device name is not known, if the device is not open, or if there was not enough memory to complete the operation, the return value is zero.

Remarks

Each file for a compound device has a unique device identifier. The identifier of the "all" device is MCI_ALL_DEVICE_ID.

QuickInfo

  Windows NT: Requires version 3.1 or later.
  Windows: Requires Windows 95 or later.
  Windows CE: Unsupported.
  Header: Declared in mmsystem.h.
  Import Library: Use winmm.lib.
  Unicode: Implemented as Unicode and ANSI versions on Windows NT.

See Also

MCI Overview, MCI Functions, mciSendCommand