MCI_GETDEVCAPS

This MCI command message is used to obtain static information about a device. Information is returned in the dwReturn field of the data structure identified by lParam2.

Parameters DWORD lParam1 The following standard and command-specific flags apply to all devices:

MCI_NOTIFY

Specifies that MCI should post the MM_MCINOTIFY message when this command completes. The window that receives this message is specified in the dwCallback field of the data structure identified by lParam2.

MCI_TEST

Queries the device to determine if it can execute the command. The device returns an error if it is incapable of executing the command. It returns no error if it can handle the command. MCI returns control to the application without executing the command.

MCI_WAIT

Specifies that the query operation should finish before MCI returns control to the application.

MCI_GETDEVCAPS_ITEM

Specifies that a constant indicating a device capability is included in the dwItem field of the data structure identified by lParam2. The following constants are defined for all devices:


MCI_GETDEVCAPS_CAN_EJECT

The dwReturn field is set to TRUE if the device can eject the media; otherwise, it is set to FALSE. Digital-video devices set it to FALSE.

MCI_GETDEVCAPS_CAN_PLAY

The dwReturn field is set to TRUE if the device can play the media; otherwise, it is set to FALSE. Digital-video devices set it to TRUE. Overlay devices set it to FALSE. Supporting MCI_PLAY implies the device also supports MCI_PAUSE and MCI_STOP.

MCI_GETDEVCAPS_CAN_RECORD

The dwReturn is set to TRUE if the device supports recording (digitizing) of audio data, video data, or both; otherwise, it is set to FALSE. If a device specifies TRUE, it implies the device supports MCI_PAUSE and MCI_STOP as well as MCI_RECORD.

MCI_GETDEVCAPS_CAN_SAVE

The dwReturn field is set to TRUE if the device can save digitized images, audio, and/or video in a file; otherwise, it is set to FALSE.

MCI_GETDEVCAPS_COMPOUND_DEVICE

The dwReturn field is set to TRUE if the device uses device elements; otherwise, it is set to FALSE. Digital-video devices return TRUE. Overlay devices return FALSE.

MCI_GETDEVCAPS_DEVICE_TYPE

The dwReturn field is set to MCI_DEVTYPE_DIGITAL_VIDEO to indicate the device type for digital-video devices and MCI_DEVTYPE_OVERLAY for overlay devices.

MCI_GETDEVCAPS_HAS_AUDIO

The dwReturn field is set to TRUE if the device has audio output; otherwise, it is set to FALSE.

MCI_GETDEVCAPS_HAS_VIDEO

The dwReturn field is set to TRUE if the device supports video playback; otherwise, it is set to FALSE.

MCI_GETDEVCAPS_USES_FILES

The dwReturn field is set to TRUE if the device requires a filename as its element name; otherwise, it is set to FALSE. Digital-video devices use files and return TRUE.


LPMCI_GETDEVCAPS_PARMS lParam2

Specifies a far pointer to the MCI_GETDEVCAPS_PARMS data structure.