MCI_PASTE

	Overview

	Group

	Quick Info

The MCI_PASTE command pastes data from the clipboard into a file. Digital-video devices recognize this command.

MCIERROR mciSendCommand(MCIDEVICEID wDeviceID, MCI_PASTE,
DWORD dwlags, (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

Address of an MCI_DGV_PASTE_PARMS structure.

Return Values
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.