STATUS (CD/XA Commands)

The STATUS command obtains status information for the device.

Syntax

status object keywords

Syntax Diagram

 STATUS ─── object ───┬── CHANNEL number ──┬───┬──────────┬────┤
                      ├── LENGTH ──────────┤   ├─ WAIT ───┤
                      ├── MEDIA PRESENT ───┤   └─ NOTIFY ─┘
                      ├── MODE ────────────┤
                      ├── POSITION ────────┤
                      ├── READY ───────────┤
                      ├── TIME FORMAT ─────┤
                      └── VOLUME ──────────┘

Parameters

object

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

Device type
Device name
Filename
Alias

CHANNEL number: Returns audio device, audio buffer, video buffer, data buffer, none, right, all, or left for the destination of the data in the channel specified by number.
LENGTH: Returns MCIERR_INDETERMINATE_LENGTH. The length of a CD-XA file cannot be determined in this release of OS/2 multimedia.
MEDIA PRESENT: Returns TRUE if the media is inserted in the device; otherwise, it returns FALSE.
MODE: Returns the current mode of the device: not ready, stopped, playing, seeking, recording, paused, or other.
POSITION: Returns the current position.
READY: Returns TRUE if the device is ready.
TIME FORMAT: Returns the time format.
VOLUME: Returns the current volume setting. The volume is returned as a string in the format left:right where left and right are percentages of the maximum achievable effect for the left and right channels respectively. Leading zeros are suppressed for the volume level in each channel.
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 Code

status cdxa mode wait