|
MCI_SAVE
The MCI_SAVE command saves the current file. Devices that modify files should not destroy
the original copy until they receive the save message. Video-overlay and
waveform-audio devices recognize this command. Although digital-video devices and
MIDI sequencers also recognize this command, the MCIAVI and MCISEQ drivers do not
implement it.
MCIERROR mciSendCommand(MCIDEVICEID wDeviceID, MCI_SAVE,
DWORD dwFlags, (DWORD) (LPMCI_SAVE_PARMS ) lpSave);
Parameters
wDeviceID
Device identifier of the MCI device that is to receive the command message.
dwFlags
MCI_NOTIFY, MCI_WAIT, or, for digital-video and VCR devices, MCI_TEST. For
information about these flags, see The Wait, Notify, and Test Flags.
lpSave
Address of an MCI_SAVE_PARMS structure. (Devices with additional parameters might replace this structure
with a device-specific structure.)
Return Values
Returns zero if successful or an error otherwise.
Remarks
This command is supported by devices that return TRUE when you call the MCI_GETDEVCAPS command with the MCI_GETDEVCAPS_CAN_SAVE flag.
The following additional flag applies to all devices supporting MCI_SAVE:
MCI_SAVE_FILE
The lpfilename member of the structure identified by lpSave contains an address of a buffer containing the destination filename.
The following additional flags are used with the digitalvideo device type:
MCI_DGV_RECT
The rc member of the structure identified by lpSave contains a valid rectangle. The rectangle specifies a region of the frame
buffer that will be saved to the specified file. The first pair of coordinates
specifies the upper left corner of the rectangle; the second pair specifies the
width and height. Digital-video devices must use the MCI_CAPTURE command to capture the contents of the frame buffer. (Video-overlay devices
should also use MCI_CAPTURE.) This flag is for compatibility with the existing MCI video-overlay command
set.
MCI_DGV_SAVE_ABORT
Stops a save operation in progress. This must be the only flag present.
MCI_DGV_SAVE_KEEPRESERVE
Unused disk space left over from the original MCI_RESERVE command is not deallocated.
For digital-video devices, the lpSave parameter points to an MCI_DGV_SAVE_PARMS structure.
The following additional flag is used with the overlay device type:
MCI_OVLY_RECT
The rc member of the structure identified by lpSave contains a valid display rectangle indicating the area of the video buffer to
save.
For video-overlay devices, the lpSave parameter points to an MCI_OVLY_SAVE_PARMS structure.
See Also
MCI_CAPTURE, MCI_DGV_SAVE_PARMS, MCI_GETDEVCAPS, MCI_OVLY_SAVE_PARMS, MCI_RESERVE, MCI_SAVE_PARMS
Related Links
Software for Delphi and C++ Builder developers
Software for Visual Studio .NET developers
Software for Visual Basic 6 developers
Delphi Tips&Tricks
MegaDetailed.NET
TMS Scripter Studio Pro components for Delphi/C++Builder
More Online Helps
Win32 Programmer's Reference (win32.hlp)
OLE Programmer's Reference (ole.hlp)
Microsoft Windows Pen API Programmer's Reference (penapi.hlp)
Microsoft Windows Sockets 2 Reference (sock2.hlp)
Microsoft Windows Telephony API (TAPI) Programmer's Reference (tapi.hlp)
Unix Manual Pages
|
