Responding to the MCI_INFO Message

Applications use the MCI_INFO message to obtain string information from a device. An application will supply a pointer to a MCI_INFO_PARMS data structure. This structure has the following fields:

typedef struct {

DWORD dwCallback; // Callback for MCI_NOTIFY

LPSTR lpstrReturn; // Pointer to information returned to application

DWORD dwRetSize; // Size of application supplied buffer

} MCI_INFO_PARMS;

The lpstrReturn field of this data structure contains a pointer to an application supplied buffer. Its size is indicated by the dwRetSize field. Use this buffer to return a null-terminated string containing the information from your device driver.

Flags specified in the lParam1 parameter of DriverProc specifies the type of information your driver should return. The MCI_INFO_PRODUCT flag requests the product information from the device driver. This information should include the manufacturer of the hardware and, if possible, the model information. If your device driver applies to a device type rather than a specific device, you should return the long name of the device type. Other flags can extend the MCI_INFO message to request other information, however, MCI_INFO should not be used to return information available with the MCI_STATUS message.