MCI_RECORD

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.

Returns zero if successful. Otherwise, it returns an MCI error code. MCISEQ returns MCIERR_UNSUPPORTED_FUNCTION for this command.

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.

MCI_RECORD

See Also