CAPABILITY

The CAPABILITY command requests information about a particular capability of a device.

Syntax

CAPABILITY ─── [[object]] ───┬─ CAN EJECT ────────┬───┬──────────┬───┤
                         ├─ CAN PLAY ─────────┤   ├─ WAIT    ─┤
                         ├─ CAN RECORD ───────┤   └─ NOTIFY  ─┘
                         ├─ CAN SAVE ─────────┤
                         ├─ CAN LOCKEJECT ────┤
                         ├─ CAN SETVOLUME ────┤
                         ├─ COMPOUND DEVICE ──┤
                         ├─ DEVICE TYPE ──────┤
                         ├─ HAS AUDIO ────────┤
                         ├─ HAS VIDEO ────────┤
                         ├─ MESSAGE command ──┤
                         ├─ PREROLL TIME ─────┤
                         ├─ PREROLL TYPE ─────┤
                         └─ USES FILES ───────┘

Keywords

object

Object associated with this media control interface command. The object can be one of the following:

Device type
Device name
Filename
Alias

CAN EJECT: Returns TRUE if the device can eject the media.

CAN PLAY: Returns TRUE if the device can play.

CAN RECORD: Returns TRUE if the device supports recording.

CAN SAVE: Returns TRUE if the device can save data.

CAN LOCKEJECT: Returns TRUE if the device can disable the manual ejection of the media.

CAN SETVOLUME: Returns TRUE if the device supports software control of volume level.

COMPOUND DEVICE: Returns TRUE if the device requires an element name.

DEVICE TYPE: Returns one of the following: ampmix, cdaudio, cdxa, digitalvideo, overlay, sequencer, videodisc, waveaudio, or other.

HAS AUDIO: Returns TRUE if the device supports audio playback.

HAS VIDEO: Returns TRUE if the device supports video playback.

MESSAGE command: Returns TRUE if the device supports the command specified by command. Following are the commands you can query:

ACQUIRE	RECORD
CAPABILITY	RELEASE
CLOSE	RESUME
CONNECTION	SAVE
CONNECTOR	SEEK
CUE	SET
ESCAPE	SETCUEPOINT
GROUP	SETPOSITIONADVISE
INFO	SPIN
LOAD	STATUS
MASTERAUDIO	STEP
OPEN	STOP
PAUSE	SYSINFO
PLAY

PREROLL TIME: Returns the deterministic or maximum notified preroll time in MMTIME units. A value of 0 for a notified preroll device indicates the preroll time is not bounded.

PREROLL TYPE: Returns the preroll characteristics of the device. Returns notified if the preroll time for the device is variable. Returns deterministic if the prerolled time for the device is fixed. Returns none if the device does not support preroll.

USES FILES: Returns TRUE if the device requires a file path name.

WAIT: The command is executed synchronously. The function waits until the requested action is complete before returning to the application. The WAIT keyword must be specified in order to receive return string information.

NOTIFY: The command is executed asynchronously, allowing control to be returned immediately to the application. When the requested action is complete, an MM_MCINOTIFY message is sent to the application window procedure.

Example

capability waveaudio01 can record wait