MCI_INFO

Obtains string information from a device. All devices respond to this message. The parameters and flags available for this message depend on the selected device. Information is returned in the lpstrReturn member of the structure identified by lpInfo. The dwReturnSize member specifies the buffer length for the return data.

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 to receive this message is specified in the dwCallback member of the structure identified by lpInfo.

MCI_WAIT

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

MCI_INFO_PRODUCT

Obtains a description of the hardware associated with a device. Devices should supply a description that identifies both the driver and the hardware used.


LPMCI_INFO_PARMS lParam2

Specifies a far pointer to the MCI_INFO_PARMS structure. (Devices with extended command sets might replace this structure with a device-specific structure.)

Animation Extensions

The following additional flags for lParam1apply to animation devices:

MCI_INFO_FILE

Obtains the filename of the current file. This flag is only supported by devices that return TRUE to the MCI_GETDEVCAPS_USES_FILES query.

MCI_ANIM_INFO_TEXT

Obtains the window caption.


Note that lParam2specifies a far pointer to the MCI_INFO_PARMS structure.

Video Overlay Extensions

The following additional flags for lParam1apply to video overlay devices:

MCI_INFO_FILE

Obtains the filename of the current file. This flag is only supported by devices that return TRUE to the MCI_GETDEVCAPS_USES_FILES query.

MCI_OVLY_INFO_TEXT

Obtains the caption of the window associated with the overlay device.


Note that lParam2 specifies a far pointer to the MCI_INFO_PARMS structure.

Waveform Audio Extensions

The following additional flags for lParam1 apply to waveform audio devices:

MCI_INFO_FILE

Obtains the filename of the current file. This flag is supported by devices that return TRUE to the MCI_GETDEVCAPS_USES_FILES query.

MCI_WAVE_INPUT

Obtains the product name of the current input.

MCI_WAVE_OUTPUT

Obtains the product name of the current output.


Note that lParam2 specifies a far pointer to the MCI_INFO_PARMS structure.

If an application requests return-string information and it does not supply a buffer large enough to hold it, your device driver should fill the buffer and truncate the string. Return MCIERR_PARAM_OVERFLOW to indicate the information in the buffer was truncated.