LOAD

The LOAD command loads a new device element (file) into an already open device context.

Syntax

LOAD ─── object ───┬────────────┬───┬──────────┬───┤
                   ├─ filename ─┤   ├─ WAIT    ─┤
                   └─ NEW ──────┘   └─ 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

filename

Name of the file to be loaded.

NEW

Creates a temporary element for subsequent use. The temporary file can be made permanent by providing a name using the SAVE command.

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 LOAD command loads a new device element (file) into an already open device context.

Example

open digitalvideo01 alias video1 wait
load video1 movie.avi wait