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.
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. |
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.
MCI_LOAD