PLAY

The PLAY command starts playing the device.

Note: PLAY can be used on a file without a preceding OPEN.

Syntax

PLAY ─── object ───┬────────────┬───┬──────────┬───┤
                   ├─ FROM pos ─┤   ├─ WAIT    ─┤
                   └─ TO pos   ─┘   └─ 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

FROM pos

Specifies the position at which to start playing. If FROM is omitted, the device starts playing at the current position; if TO is omitted, the device plays to the end position.

TO pos

Specifies the position at which to stop playing. If FROM is omitted, the device starts playing at the current position; if TO is omitted, the device plays to the end position.

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

play digitalvideo wait