MCI_RECORD

This MCI command message starts recording from the current position or from the specified position until the specified position. Support of this message by a device is optional. The parameters and flags for this message vary according to the selected device.

Parameters

DWORD lParam1

The following flags apply to all devices supporting MCI_RECORD:


MCI_NOTIFY

Specifies that MCI should post the MM_MCINOTIFY message when this command completes. The window that receives this message is specified in the dwCallback field of the data structure identified by lParam2.

MCI_TEST

Queries the device to determine if it can execute the command. The device returns an error if it is incapable of executing the command. It returns no error if it can handle the command. MCI returns control to the application without executing the command.

MCI_WAIT

Specifies that recording should finish before MCI returns control to the application.

MCI_FROM

Specifies that a starting position is included in the dwFrom field of the data structure identified by lParam2. The units assigned to the position values are specified with the MCI_SET_TIME_FORMAT flag of the MCI_SET command. The starting position indicates where recording should begin in the workspace. If this item is omitted, the default starting position is the current position in the workspace.

MCI_RECORD_INSERT

Indicates that recorded data should be inserted in the existing workspace file. (This is the default.) Recording starts at the position specified by the MCI_FROM value and the data presently in the workspace is preserved. The duration of recording is the difference between the values specified for the MCI_TO and MCI_FROM flags.

MCI_RECORD_OVERWRITE

Specifies that recorded data should replace data already present in the workspace file. The frames replaced are designated by values for the MCI_FROM and MCI_TO flags.

MCI_TO

Specifies that an ending position is included in the dwTo field of the data structure identified by lParam2. The value specifies the frame in the recorded file where recording should cease. The audio and video data recorded are excusive of this position. When recording is complete, the workspace is at the specified position in the mode defined for the MCI_SEEK command. If MCI_TO is not specified the device records until an MCI_STOP or MCI_PAUSE command is sent. The units assigned to the position values are specified with the MCI_SET_TIME_FORMAT flag of the MCI_SET command.