CAPABILITY (CD Audio Commands)

The CAPABILITY command requests additional information about the capabilities of the CD audio device.

Syntax

CAPABILITY ─── object ──┬─────────────────────────┬───┬──────────┬───┤
                        ├─ CAN EJECT ─────────────┤   ├─ WAIT   ─┤
                        ├─ CAN LOCKEJECT ─────────┤   └─ NOTIFY ─┘
                        ├─ CAN PLAY ──────────────┤
                        ├─ CAN PROCESS INTERNAL ──┤
                        ├─ CAN RECORD ────────────┤
                        ├─ CAN SAVE ──────────────┤
                        ├─ CAN SETVOLUME ─────────┤
                        ├─ CAN STREAM ────────────┤
                        ├─ COMPOUND DEVICE ───────┤
                        ├─ DEVICE TYPE ───────────┤
                        ├─ HAS AUDIO ─────────────┤
                        ├─ HAS VIDEO ─────────────┤
                        ├─ PREROLL TIME ──────────┤
                        ├─ PREROLL TYPE ──────────┤
                        └─ USES FILES ────────────┘

Keywords

object: Object associated with this media control interface command (Device type, name, filename, or alias).
CAN EJECT: Returns TRUE if the CD audio device can eject the media.
CAN LOCKEJECT: Returns TRUE if the device can disable manual ejection of the media.
CAN PLAY: Returns TRUE if the CD audio device can play the media.
CAN PROCESS INTERNAL: Returns TRUE if the device has an internal digital-to-analog converter (DAC) to process data internally.
CAN RECORD: Returns FALSE. CD audio devices cannot record.
CAN SAVE: Returns FALSE. CD audio devices cannot save data.
CAN SETVOLUME: Returns TRUE if the device supports software control of the volume level.
CAN STREAM: Returns TRUE if the device can continuously transfer digital data to or from another device.
COMPOUND DEVICE: Returns FALSE. CD audio devices are categorized as simple devices.
DEVICE TYPE: Returns **CDaudio**.
HAS AUDIO: Returns TRUE.
HAS VIDEO: Returns FALSE. CD audio devices do not support video.
PREROLL TIME: Returns 0, indicating the preroll time is not bounded.
PREROLL TYPE: Returns the preroll characteristics (Returns **NONE**).
USES FILES: Returns FALSE. CD audio devices do not use files.
WAIT: Executes the command synchronously. The function waits until the action is complete. **Note:** This must be specified to receive return string information.
NOTIFY: Executes the command asynchronously and sends an MM_MCINOTIFY message upon completion.

Purpose

The CAPABILITY command allows an application to determine the specific functional limits and features of the connected CD audio hardware.

Example

capability cdaudio can record wait

*(Returns FALSE)*