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);
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.) |
Returns zero if successful or an error otherwise.
The change becomes permanent only when the data is explicitly saved; however, playback acts as if the data has been removed.
Windows NT: Requires version 3.1 or later.
Windows: Requires Windows 95 or later.
Windows CE: Unsupported.
MCI Overview, MCI Command Strings