MCI_SAVE

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.

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.

See Also

MCI_LOAD