RECORD

The RECORD command starts recording data. By default, recording does not overwrite existing data but rather inserts data at the current position. On devices that cannot support inserting data (such as audio or video tape), recording overwrites existing data by default.

Syntax

RECORD ─── object ───┬────────────┬───┬─────────────┬───┬──────────┬───┤
                     ├─ FROM pos ─┤   ├─ INSERT     ─┤   ├─ WAIT    ─┤
                     └─ TO pos   ─┘   └─ OVERWRITE  ─┘   └─ 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 recording. If FROM is omitted, the device starts recording at the current position; if TO is omitted, the device records to the end position.

TO pos: Specifies the position at which to stop recording. If FROM is omitted, the device starts recording at the current position; if TO is omitted, the device records to the end position.

INSERT: Data is to be added to the device element. This is the default on devices that support insertion of data (file-oriented devices). Returns MCI_UNSUPPORTED_FLAG on devices that do not support INSERT.

OVERWRITE: Recorded data replaces existing data in the device element. This is the default on devices that do not support insertion of data (for example, videotape).

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 RECORD command starts recording data. By default, recording does not overwrite existing data but rather inserts data at the current position. On devices that cannot support inserting data (such as audio or video tape), recording overwrites existing data by default.

Example

record digitalvideo notify