This MCI command message 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 field of the data 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 field of the data 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 data structure. (Devices with additional parameters might replace this data structure with a device-specific data structure.)
DWORD lParam1
The following additional flags apply to video overlay devices supporting MCI_SAVE:
MCI_OVLY_RECT
Specifies that the rc field of the data structure identified by lParam2 contains a valid display rectangle indicating the area of the video buffer to save.
LPMCI_OVLY_SAVE_PARMS lParam2
Specifies a far pointer to a MCI_OVLY_SAVE_PARMS data structure.
Returns zero if successful. Otherwise, it returns an MCI error code. MCISEQ returns MCIERR_UNSUPPORTED_FUNCTION.
This command is supported by devices that return true to the MCI_GETDEVCAPS_CAN_SAVE query. MCIWAVE supports this command.