cut
The cut
command removes data from the workspace and copies it to the clipboard.
Digital-video devices recognize this command.
wsprintf(lpstrCommand, "cut %s %s %s",
lpszDeviceID, lpszItem,
lpszFlags);
Parameters
lpszDeviceID
Identifier of
an MCI device. This identifier or alias is assigned when the device is opened.
lpszItem
One of the
following flags identifying the item to cut:
|
at rectangle |
Specifies
the portion of each frame cut. If omitted, it defaults to the entire frame.
When this item is specified, frames are not deleted. Instead the area inside
the rectangle becomes black. |
|
audio
stream stream |
Specifies
the audio stream in the workspace affected by the command. If you use this
flag and also want to cut video, you must also use the video stream flag.
(If neither flag is specified, all audio and video streams are cut.) |
|
from position |
Specifies the
start of the range cut. If omitted, it defaults to the current position. |
|
to position |
Specifies
the end of the range cut. The audio and video data cut are exclusive of this
position. If omitted it defaults to the end of the workspace. |
|
video
stream stream |
Specifies
the video stream in the workspace affected by the command. If you use this flag
and also want to cut audio, you must also use the audio stream flag. (If
neither flag is specified, all audio and video streams are cut.) |
lpszFlags
Can be
wait , notify , test , or a combination of these. For more information about
these flags, see The Wait, Notify, and Test Flags4FW.04J.
Return Values
Returns zero
if successful or an error otherwise.
Remarks
The change
becomes permanent only when the data is explicitly saved; however, playback
acts as if the data has been removed.