MCI_RECORD

See also MCI_CUE, MCI_PAUSE, MCI_PLAY, MCI_RESUME, MCI_SEEK

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.

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 to receive this message is specified in the dwCallback member of the structure identified by lpRecord.

MCI_WAIT

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

MCI_RECORD_INSERT

Indicates that newly recorded information should be inserted or pasted into the existing data. (Some devices may not support this.) If supported, this is the default.

MCI_FROM

Specifies that a starting position is included in the dwFrom member of the structure identified by lpRecord. The units assigned to the position values is specified with the MCI_SET_TIME_FORMAT flag of the MCI_SET command. If MCI_FROM is not specified, the starting position defaults to the current location.

MCI_RECORD_OVERWRITE

Specifies that data should overwrite existing data. MCIWAVE returns MCIERR_UNSUPPORTED_FUNCTION in response to this flag.

MCI_TO

Specifies that an ending position is included in the dwTo member of the structure identified by lpRecord. The units assigned to the position values is specified with the MCI_SET_TIME_FORMAT flag of the MCI_SET command. If MCI_TO is not specified, the ending position defaults to the end of the media.


LPMCI_RECORD_PARMS lParam2

Specifies a far pointer to the MCI_RECORD_PARMS structure. (Devices with extended command sets might replace this structure with a device-specific structure.)

This command is supported by devices that return TRUE to the MCI_GETDEVCAPS_CAN_RECORD query.