INFO (CD Audio Commands)

The INFO command fills a user-supplied buffer with descriptive information about the CD audio device or the loaded media.

Syntax

INFO ─── object ──┬─ ID ──────┬───┬──────────┬───┤
                  ├─ PRODUCT ─┤   ├─ WAIT   ─┤
                  └─ UPC ─────┘   └─ NOTIFY ─┘

Keywords

object

Object associated with this media control interface command (Device type, name, filename, or alias).

ID

Returns the unique disc ID. If the device does not support this function, it returns 0. The value is returned in a binary format.

PRODUCT

Returns a string containing the product name and model of the current audio device.

UPC

Returns the Universal Product Code (serial number) of the disc. If the device cannot read the UPC or the function is unsupported, it returns 0. The value is returned in a binary format.

WAIT

Executes the command synchronously. The function will not return until the information has been retrieved and placed in the buffer.

NOTIFY

Executes the command asynchronously. An MM_MCINOTIFY message is sent to the application window procedure once the information is available.

Purpose

The INFO command is primarily used to identify hardware or specific media. This is particularly useful for applications that need to recognize a specific CD to load saved settings (via ID or UPC) or to display hardware details to the user (via PRODUCT).

Example

info cdaudio product wait

*(Returns a string such as "Sony CD-ROM CDU-33A" depending on the hardware)*