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.
DWORD dwFlags
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 field of the data 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 field of the data 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 field of the data 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 lpRecord
Specifies a far pointer to the MCI_RECORD_PARMS data structure. (Devices with extended command sets might replace this data structure with a device-specific data structure.)
Returns zero if successful. Otherwise, it returns an MCI error code.
MCISEQ returns MCIERR_UNSUPPORTED_FUNCTION for this command.
This command is supported by devices that return TRUE to the MCI_GETDEVCAPS_CAN_RECORD query.
MCI_CUE, MCI_PAUSE, MCI_PLAY, MCI_RESUME, MCI_SEEK