SEEK

The SEEK command finds the specified position and stops.

Syntax

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

Keywords

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 position at which to stop the seek. If it is greater than the length of the media, an OUT OF RANGE error is returned.

TO START

Seek to the beginning of the media.

TO END

Seek to the end of the media.

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.

Purpose

The SEEK command finds the specified position and stops.

Example

seek digitalvideo to start wait