SEEK (CD/XA Commands)

The SEEK command finds the specified location on the disc.

Note: Seeking to a given position in a CD-XA file requires the media control driver to essentially play to that point from the beginning of the file.

Syntax

seek object keywords

Syntax Diagram

SEEK ──── object ────┬─ TO pos ───┬───┬──────────┬────┤
                     ├─ TO START ─┤   ├─ WAIT ───┤
                     └─ TO END ───┘   └─ NOTIFY ─┘

Parameters

object

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

Device type
Device name
Filename
Alias

TO pos: The destination position for the seek. If it is greater than the length of the disc, an MCIERR_OUTOFRANGE error is returned.
TO START: Seeks to the first playable location on the disc.
TO END: Seeks to the end of the disc.
WAIT: The command is executed synchronously. The function waits until the requested action is complete before returning to the application.
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

open cdxa alias cd shareable wait
load cd music.xa wait
seek cd to end wait