MCI_RECORD command
The MCI_RECORD command starts recording from the current position or from one specified location to another specified location. VCR and waveform-audio devices recognize this command. Although digital-video devices and MIDI sequencers also recognize this command, the MCIAVI and MCISEQ drivers do not implement it.
To send this command, call the mciSendCommand function with the following parameters.
MCIERROR mciSendCommand(
MCIDEVICEID wDeviceID,
MCI_RECORD,
DWORD dwFlags,
(DWORD) (LPMCI_RECORD_PARMS) lpRecord
);
Parameters
-
wDeviceID
-
Device identifier of the MCI device that is to receive the command message.
-
dwFlags
-
MCI_NOTIFY, MCI_WAIT, or, for digital-video and VCR devices, MCI_TEST. For information about these flags, see The Wait, Notify, and Test Flags.
-
lpRecord
-
Pointer to an MCI_RECORD_PARMS structure. (Devices with extended command sets might replace this structure with a device-specific structure.)
Return Value
Returns zero if successful or an error otherwise.
Remarks
This command is supported by devices that return TRUE when you call the MCI_GETDEVCAPS command with the MCI_GETDEVCAPS_CAN_RECORD flag. For the MCIWAVE driver, all data recorded after a file is opened is discarded if the file is closed without saving it.
The following additional flags apply to all devices supporting MCI_RECORD:
-
MCI_FROM
-
A starting location is included in the dwFrom member of the structure identified by lpRecord. 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 location defaults to the current position.
-
MCI_RECORD_INSERT
-
Newly recorded information should be inserted or pasted into the existing data. Some devices might not support this. If supported, this is the default.
-
MCI_RECORD_OVERWRITE
-
Data should overwrite existing data. The MCIWAVE.DRV device returns MCIERR_UNSUPPORTED_FUNCTION in response to this flag.
-
MCI_TO
-
An ending location is included in the dwTo member of the structure identified by lpRecord. 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 ending location defaults to the end of the content.
The following additional flags are used with the digitalvideo device type:
-
MCI_DGV_RECORD_AUDIO_STREAM
-
An audio-stream number is included in the dwAudioStream member of the structure identified by lpRecord. If you omit this flag, audio data is recorded into the first physical stream.
-
MCI_DGV_RECORD_HOLD
-
When recording stops, the screen will hold the last image and will not resume showing the video until an MCI_MONITOR command is issued.
-
MCI_DGV_RECORD_VIDEO_STREAM
-
A video-stream number is included in the dwVideoStream member of the structure identified by lpRecord. If you omit this flag, video data is recorded into the first physical stream.
-
MCI_DGV_RECT
-
A rectangle is specified in the rc member of the structure identified by lpRecord. The rectangle specifies the region of the external input used as the source for the pixels compressed and saved. This rectangle defaults to the rectangle specified (or defaulted) by the MCI_DGV_PUT_VIDEO flag for the MCI_PUT command. When it is set differently than the video rectangle, what is displayed is not what is recorded
For digital-video devices, lpRecord points to an MCI_DGV_RECORD_PARMS structure.
The following additional flags are used with the vcr device type:
-
MCI_VCR_RECORD_AT
-
The dwAt member of the structure identified by lpRecord contains a time when the entire command begins, or if the device is cued, when the device reaches the from position given by the cue command.
-
MCI_VCR_RECORD_INITIALIZE
-
Seek the device to the start of the media, begin recording blank video and audio, and record timecode, if possible.
For VCR devices, lpRecord points to an MCI_VCR_RECORD_PARMS structure.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client |
Windows 2000 Professional [desktop apps only] |
| Minimum supported server |
Windows 2000 Server [desktop apps only] |
| Header |
|