MCI_PASTE command
The MCI_PASTE command pastes data from the clipboard into a file. Digital-video devices recognize this command.
To send this command, call the mciSendCommand function with the following parameters.
MCIERROR mciSendCommand(
MCIDEVICEID wDeviceID,
MCI_PASTE,
DWORD dwFlags,
(DWORD) (LPMCI_DGV_PASTE_PARMS) lpPaste
);
Parameters
-
wDeviceID
-
Device identifier of the MCI device that is to receive the command message.
-
dwFlags
-
MCI_NOTIFY, MCI_WAIT, or MCI_TEST. For information about these flags, see The Wait, Notify, and Test Flags.
-
lpPaste
-
Pointer to an MCI_ DGV_ PASTE_ PARMS structure.
Return Value
Returns zero if successful or an error otherwise.
Remarks
The following additional flags apply to digital-video devices:
-
MCI_DGV_PASTE_AT
-
A rectangle is included in the rc member of the structure identified by lpPaste. The first two values of the rectangle specify the point within the frame to place the clipboard information. If the rectangle height and width are nonzero, the clipboard contents are scaled to those dimensions when they are pasted in the frame. If the flag is omitted, MCI_PASTE defaults to the entire frame rectangle.
-
MCI_DGV_PASTE_AUDIO_STREAM
-
An audio-stream number is included in the dwAudioStream member of the structure identified by lpPaste. If only one audio stream exists on the clipboard, the audio data is pasted into the designated stream. If more than one audio stream exists on the clipboard, the stream indicates the starting number for the stream sequences. If you use this flag and also want to paste video, you must also use the MCI_DGV_PASTE_VIDEO_STREAM flag. (If neither flag is specified, all audio and video streams are pasted starting with the first audio and video stream. Each pasted stream retains its original stream number.)
-
MCI_DGV_PASTE_INSERT
-
Clipboard data should be inserted in the existing workspace at the position specified by the MCI_TO flag. Any existing data after the insertion point is moved in the workspace to make room. This is the default.
-
MCI_DGV_PASTE_OVERWRITE
-
Clipboard data should replace data already present in the workspace. The workspace data replaced follows the insertion point.
-
MCI_DGV_PASTE_VIDEO_STREAM
-
A video-stream number is included in the dwVideoStream member of the structure identified by lpPaste. If only one video stream exists on the clipboard, the video data is pasted into the designated stream. If more than one video stream exists on the clipboard, the stream indicates the starting number for the stream sequences. If you use this flag and also want to paste audio, you must also use the MCI_DGV_PASTE_AUDIO_STREAM flag. (If neither flag is specified, all audio and video streams are pasted starting with the first audio and video stream. Each pasted stream retains its original stream number.)
-
MCI_TO
-
A position value is included in the dwTo member of the structure identified by lpPaste. The position value specifies the position to begin pasting data into the workspace. If this flag is omitted, the position defaults to the current position.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client |
Windows 2000 Professional [desktop apps only] |
| Minimum supported server |
Windows 2000 Server [desktop apps only] |
| Header |
|