MCI_SAVE command

The MCI_SAVE command saves the current file. Devices that modify files should not destroy the original copy until they receive the save message. Video-overlay 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_SAVE, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_SAVE_PARMS ) lpSave
);

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.

lpSave

Pointer to an MCI_SAVE_PARMS structure. (Devices with additional parameters 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_SAVE flag.

The following additional flag applies to all devices supporting MCI_SAVE:

MCI_SAVE_FILE

The lpfilename member of the structure identified by lpSave contains an address of a buffer containing the destination filename.

The following additional flags are used with the digitalvideo device type:

MCI_DGV_RECT

The rc member of the structure identified by lpSave contains a valid rectangle. The rectangle specifies a region of the frame buffer that will be saved to the specified file. The first pair of coordinates specifies the upper left corner of the rectangle; the second pair specifies the width and height. Digital-video devices must use the MCI_CAPTURE command to capture the contents of the frame buffer. (Video-overlay devices should also use MCI_CAPTURE.) This flag is for compatibility with the existing MCI video-overlay command set.

MCI_DGV_SAVE_ABORT

Stops a save operation in progress. This must be the only flag present.

MCI_DGV_SAVE_KEEPRESERVE

Unused disk space left over from the original MCI_RESERVE command is not deallocated.

For digital-video devices, the lpSave parameter points to an MCI_DGV_SAVE_PARMS structure.

The following additional flag is used with the overlay device type:

MCI_OVLY_RECT

The rc member of the structure identified by lpSave contains a valid display rectangle indicating the area of the video buffer to save.

For video-overlay devices, the lpSave parameter points to an MCI_OVLY_SAVE_PARMS structure.

Requirements

Requirement Value
Minimum supported client
Windows 2000 Professional [desktop apps only]
Minimum supported server
Windows 2000 Server [desktop apps only]
Header
Mmsystem.h (include Windows.h)

See also

MCI

MCI Commands