copy
The copy command copies data to the clipboard. Digital-video devices recognize this command.
To send this command, call the mciSendString function with the lpszCommand parameter set as follows.
_stprintf_s(
lpszCommand,
TEXT("copy %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 copy.
| Value | Meaning |
| at rectangle | Specifies the portion of each frame that will be copied. If omitted, the default setting is the entire frame. |
| audio stream stream | Specifies the audio stream in the workspace affected by the command. If you use this flag and also want to copy video, you must also use the "video stream" flag. (If neither flag is specified, all audio and video streams are copied.) |
| from position | Specifies the start of the range copied. If omitted, the default setting is the current position. |
| to position | Specifies the end of the range copied. The audio and video data copied are exclusive of this position. If omitted, the default setting is 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 copy audio, you must also use the "audio stream" flag. (If neither flag is specified, all audio and video streams are copied.) |
lpszFlags
Can be "wait", "notify", "test", or a combination of these. For more information about these flags, see The Wait, Notify, and Test Flags.
Return Values
Returns zero if successful or an error otherwise.
Requirements
** Windows NT/2000/XP:** Included in Windows NT 3.1 and later.
** Windows 95/98/Me:** Included in Windows 95 and later.
See Also