This message causes the device to start recording. Before you send this message, it is recommended that you issue MCI_ACQUIREDEVICE with the MCI_EXCLUSIVE_INSTANCE flag set. This will lock the device context and prevent it from being made inactive.

Digital Video Specific

This message initiates real-time recording of motion video with simultaneous audio capture. Any options, such as frame rate, quality, and so on, in effect at the time recording starts are applied to the recording and cannot be changed during the recording process. If changes to recording options or parameters are attempted during recording, MCIERR_INVALID_MODE is returned. All recording operations entirely replace the contents of the device element at the starting location. MCI_FROM is not supported and MCI_TO is used only as an indication of the length of the recording to be performed.

ulParam1 (ULONG)

This parameter can contain any of the following flags:

MCI_NOTIFY

A notification message will be posted to the window specified in the hwndCallback parameter of the data structure pointed to by the pParam2 parameter. The notification will be posted when the action indicated by this message is completed or when an error occurs.
MCI_WAIT
Control is not to be returned until the action indicated by this message is completed or an error occurs.
MCI_FROM
Indicates a starting position is included in the ulFrom field of the data structure pointed to by pParam2. The units assigned to the position values are 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. The ulFrom field refers to a position in the destination media.
MCI_TO
Indicates an ending position is included in the ulTo field of the data structure pointed to by pParam2. The units assigned to the position values are specified with the MCI_SET_TIME_FORMAT flag of the MCI_SET command. If MCI_TO is not specified, the record will continue until a pause or stop message is received. The ulTo field refers to a position in the destination media.
MCI_RECORD_INSERT
Indicates that newly recorded information is to be inserted into existing data at the current location. Some devices, such as non-file-oriented devices, do not support this.
MCI_RECORD_OVERWRITE
Indicates that recorded data is to overwrite existing data at the current location. Note that MCI_RECORD_INSERT and MCI_RECORD_OVERWRITE are mutually exclusive.

pParam2 (PMCI_RECORD_PARMS)

A pointer to the MCI_RECORD_PARMS data structure.

rc (ULONG)

Return codes indicating success or type of failure:

MCIERR_SUCCESS

If the function succeeds, 0 is returned.
MCIERR_INVALID_DEVICE_ID
The device ID is not valid.
MCIERR_INSTANCE_INACTIVE
The device is currently inactive. Issue MCI_ACQUIREDEVICE to make device context active.
MCIERR_MISSING_FLAG
A required flag is missing.
MCIERR_UNSUPPORTED_FLAG
Given flag is unsupported for this device.
MCIERR_INVALID_CALLBACK_HANDLE
Given callback handle is invalid.
MCIERR_UNSUPPORTED_FUNCTION
Unsupported function.
MCIERR_INVALID_FLAG
Flag (ulParam1) is invalid.
MCIERR_FLAGS_NOT_COMPATIBLE
Flags cannot be used together.
MCIERR_FILE_NOT_FOUND
File has not been loaded.
MCIERR_MISSING_PARAMETER
Required parameter is missing.
MCIERR_OUTOFRANGE
The value supplied in the ulFrom field of the data structure identified by pParam2 is greater than the size of the element.
MCIERR_OUT_OF_MEMORY
There is insufficient memory to complete the requested action.
MCIERR_TARGET_DEVICE_FULL
The target device is full.

---

[Back] [Next]