Important Notice

The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.

                                                 ◄Contents► ◄Index► ◄Back►
────────────────────────────────────────────────────────────────────────────
MCI_SAVE
 
        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.
 
Parameters
        DWORD dwFlags
            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 file name.
 
        LPMCI_SAVE_PARMS lpSave
            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.)
 
        Video Overlay Extensions
 
        DWORD dwFlags
            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 lpSave contains a valid display rectangle
                indicating the area of the video buffer to save.
 
        LPMCI_OVLY_SAVE_PARMS lpSave
            Specifies a far pointer to a MCI_OVLY_SAVE_PARMS data
            structure.
 
Return value
        Returns zero if successful. Otherwise, it returns an MCI error
        code. MCISEQ returns MCIERR_UNSUPPORTED_FUNCTION.
 
Comments
        This command is supported by devices that return true to the
        MCI_GETDEVCAPS_CAN_SAVE query.
 
See also
        MCI_LOAD
 
                                       -♦-