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.