This message returns string information from a media device instance. This information does not describe the capabilities of the device, only static information about the device.

ulParam1 (ULONG)

This parameter can contain any of the following flags:

MCI_NOTIFY

A notification message will be posted to the window specified in the hwndCallback parameter of the data structure pointed to by the pParam2 parameter. The notification will be posted when the action indicated by this message is completed or when an error occurs.
MCI_WAIT
Control is not to be returned until the action indicated by this message is completed or an error occurs.
MCI_INFO_PRODUCT
This flag returns a description of the particular hardware associated with a device.
CD Audio Extensions

The following additional flags apply to CD audio devices:

MCI_CD_INFO_ID

This flag returns the disc ID (8 bytes) consisting of the starting address, ending track number, and address of the lead-out track. The disc ID is generated by the CD Audio MCD and is not necessarily unique.
MCI_CD_INFO_UPC
This flag returns the disc's UPC code (serial number) if the device supports this function; otherwise it returns 0. The UPC is BCD coded. Not all discs have UPCs.
CD-XA Extensions

The following additional flags apply to CD-XA devices:

MCI_CD_INFO_UPC

This flag returns the disc's UPC code (serial number) if the device supports this function; otherwise, it returns 0. The UPC is BCD coded. Not all discs have UPCs.
MCI_INFO_FILE
This flag returns the file name of the current file.
Digital Video Extensions

The following additional flags apply to digital video devices:

MCI_DGV_INFO_VIDEO_FILE

This flag returns the file name of the current digital video file used by the device.
MCI_DGV_INFO_IMAGE_FILE
This flag returns the file name of the current image file used by the device.
MCI_DGV_INFO_TEXT
This flag returns the caption of the window in which the digital video is currently displayed.
MCI_DGV_INFO_REGION
This flag returns the name of the current tuner region.
MCI_DGV_INFO_REGION_TEXT
This flag returns a description of the current tuner region.
Sequencer Extensions

The following additional flags apply to sequencer devices:

MCI_INFO_FILE

This flag returns the file name of the current file.
Videodisc Extensions

The following additional flags apply to videodisc devices:

MCI_VD_INFO_LABEL

This flag returns the videodisc label.
Video Overlay Extensions

The following additional flags apply to video overlay devices:

MCI_INFO_FILE

This flag returns the file name of the current file.
MCI_OVLY_INFO_TEXT
This flag returns the caption of the window in which the video overlay is currently displayed.
Wave Audio Extensions

The following additional flags apply to wave audio devices:

MCI_INFO_FILE

This flag returns the file name of the current file.

pParam2 (PMCI_INFO_PARMS)

A pointer to the MCI_INFO_PARMS data structure.

rc (ULONG)

Return codes indicating success or type of failure:

MCIERR_SUCCESS

MMPM/2 command completed successfully.
MCIERR_OUT_OF_MEMORY
System out of memory.
MCIERR_INVALID_DEVICE_ID
Invalid device ID given.
MCIERR_MISSING_PARAMETER
Missing parameter for this command.
MCIERR_UNSUPPORTED_FLAG
Flag not supported by the MMPM/2 driver for this command.
MCIERR_INVALID_CALLBACK_HANDLE
The window callback handle is not valid.
MCIERR_DRIVER
Internal MMPM/2 driver error.
MCIERR_INVALID_FLAG
Invalid flag specified for this command.
MCIERR_INVALID_BUFFER
Invalid return buffer given.
MCIERR_FILE_NOT_FOUND
File not found.
MCIERR_MISSING_FLAG
Flag missing for this MMPM/2 command.
MCIERR_FLAGS_NOT_COMPATIBLE
The flags cannot be used together.

---

[Back] [Next]