Responding to the MCI_STATUS Message

Applications use the MCI_STATUS message to determine the status of a device and device driver. An application will supply a pointer to a MCI_STATUS_PARMS structure. Your device driver should fill out the members of this structure as follows.

Use the dwReturn member to return the information indicated by the constant in dwItem. The MCI_STATUS_ITEM flag sent by the application validates the dwItem member of this structure. The contents of dwItem specify the type of information requested. The dwTrack member is used for the basic and extended commands. The following constants are always defined for MCI_STATUS:

MCI Constant

Description

MCI_STATUS_MODE

Requests the current mode of the device. The modes your driver can return include:

MCI_MODE_NOT_READY

MCI_MODE_PAUSE

MCI_MODE_PLAY

MCI_MODE_STOP

MCI_MODE_OPEN

MCI_MODE_RECORD

MCI_MODE_SEEK

MCI_STATUS_READY

Requests if the device is ready. Return TRUE if the device is ready.