MCI_SAVE

See also MCI_LOAD

Saves the current file. Devices which modify files should not destroy the original copy until they receive the save message. 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.

DWORD lParam1

The following flags apply to all devices supporting MCI_SAVE:

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 lpSave.
MCI_WAIT	Specifies that the save operation should finish before MCI returns control to the application.
MCI_SAVE_FILE	Indicates the lpfilename member of the structure identified by lpSave contains a pointer to a buffer containing the destination filename.

LPMCI_SAVE_PARMS lParam2

Specifies a far pointer to the MCI_SAVE_PARMS structure. (Devices with additional parameters might replace this structure with a device-specific structure.)

Video Overlay Extensions

The following additional flags for lParam1 apply to video overlay devices supporting MCI_SAVE:

MCI_OVLY_RECT

Specifies that the rc member of the structure identified by lParam2 contains a valid display rectangle indicating the area of the video buffer to save.

Note that lParam2specifies a far pointer to a MCI_OVLY_SAVE_PARMS structure.

This command is supported by devices that return true to the MCI_GETDEVCAPS_CAN_SAVE query. MCIWAVE supports this command.