This message is used to obtain information about the status of a device instance. MCI_STATUS returns the values most recently set by MCI_SET, MCI_LOAD, MCI_SETTUNER, and MCI_SETIMAGEBUFFER operations.
ulParam1 (ULONG)
MCI_NOTIFY
MCI_STATUS_AUDIO
MCI_STATUS_AUDIO_ALL
Note: If the time format has been set to MCI_FORMAT_TMSF, the actual time value returned will be in the format MCI_FORMAT_MSF.
If the media length cannot be determined because a playlist is currently loaded, or for any other reason, MCIERR_INDETERMINATE_LENGTH is returned.
The following additional status items apply to amplifier-mixer devices and can be specified for the ulItem field (of the data structure pointed to by pParam2) for use with the MCI_STATUS_ITEM flag:
MCI_AMP_STATUS_BALANCE
MCI_AMP_STATUS_ALC
The following additional status items apply to CD audio devices and can be specified for the ulItem field (of the data structure pointed to by pParam2) for use with the MCI_STATUS_ITEM flag:
MCI_CD_STATUS_TRACK_TYPE
Note: When used with the MCI_TRACK flag, these items return the status information of the specified track instead of the current track.
The following extensions apply to CD-XA devices and can be specified for the ulItem field of the data structure pointed to by pParam2:
MCI_CDXA_STATUS_CHANNEL
The following additional status items apply to digital video devices and can be specified for the ulItem field (of the data structure pointed to by pParam2) for use with the MCI_STATUS_ITEM flag.
MCI_DGV_STATUS_FORMATTAG
Each pixel is represented by 16 bits of data as follows:
15:5
This format uses 16 bits per pixel, but uses 4-pixel horizontal chrominance subsampling. Each pixel has a unique luminance value (Y) with a single chrominance value (U and V) shared by four pixels. Y, U, and V all have 7 bits of significance in this format.
23:8
4 bytes of Y, 2 bytes of U, 2 bytes of V; all 8-bit values in this form YUYVYUYV
The following additional status items apply to MIDI sequencer devices and can be specified for the ulItem field (of the data structure pointed to by pParam2) for use with the MCI_STATUS_ITEM flag:
MCI_SEQ_STATUS_DIVTYPE
The following additional status items apply to videodisc devices and can be specified for the ulItem field (of the data structure pointed to by pParam2) for use with the MCI_STATUS_ITEM flag:
MCI_VD_STATUS_SPEED
The following additional items apply to video overlay devices and can be specified for the ulItem field (of the data structure pointed to by pParam2) for use with the MCI_STATUS_ITEM flag.
MCI_OVLY_STATUS_HWND
Return values include:
The following additional status items apply to wave audio devices and can be specified for the ulItem field (of the data structure pointed to by pParam2) for use with the MCI_STATUS_ITEM flag:
MCI_WAVE_STATUS_FORMATTAG
pParam2 ( PMCI_STATUS_PARMS)
PMCI_CDXA_STATUS_PARMS
rc (ULONG)
Note: The format of the ulReturn value in this structure is defined by the high-order word of the value returned by mciSendCommand. This value is used by mciSendString to determine how to convert the ulReturn value to string form. For a list of the possible format values, see the MMDRVOS2.H header file. If the low-order word returned is MCIERR_SUCCESS, the high-order word could be other errors or a value. A returned value defines the format of ulReturn as defined in MMDRVOS2.H. For example, 0x5000 = MCI_TRUE_FALSE_RETURN.
Return codes indicating success or type of failure:
MCIERR_SUCCESS