MCI_INFO

The MCI_INFO message requests an MCI driver to return device or driver information.

Parameters

dwDriverID

Driver instance identifier. This is the value returned by the driver in response to the DRV_OPEN message.

hDriver

Driver handle.

uMsg

MCI_INFO

lParam1

Contains the flags specified by the application.

lParam2

Specifies a pointer to an MCI_INFO_PARMS structure, or to a customized structure.

Return Value

If the operation succeeds, the driver returns zero. Otherwise, the driver returns one of tbe MCIERR error codes defined in mmsystem.h.

Comments

A client sends the message by calling the driver's DriverProc entry point, passing the specified parameters.

A driver tests lParam1 to determine the type of information to return. The driver returns the requested information as a string in a buffer. The buffer's address and size are contained in the structure pointed to by lParam2. Refer to the Win32 SDK description of MCI_INFO to determine the types of information the driver should return.

If the application includes the MCI_INFO_PRODUCT flag, the returned string should include the manufacturer of the hardware and, if possible, model identification information. If a driver applies to a device type instead of a specific device, it should return the string name of the device type.

If a driver extends the MCI_INFO command to request additional information, it should not return information that is returned for the MCI_STATUS command.

See Also

Providing Device Information