paste    
The paste
command copies the contents of the clipboard into the workspace. Digital-video
devices recognize this command. 
wsprintf(lpstrCommand, "paste %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 or more
of the following flags:
| 
   at rectangle  | 
  
   Specifies
  the location within the frame where the data is pasted. The upper left corner
  of the rectangle corresponds to the upper left corner of the added
  data. If the rectangle has a nonzero size in X or Y, the contents of the
  clipboard are scaled in those dimensions when they are pasted into the frame.
  If omitted, the rectangle defaults to the entire frame. If this flag
  is specified in  insert  mode (the default), any region outside the rectangle
  is painted a solid color.  | 
 
| 
   audio
  stream stream  | 
  
   Specifies
  the audio stream in the workspace affected by the command. 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  video stream  flag. (If
  neither flag is specified, all audio and video streams are pasted and retain
  their original stream numbers.)   | 
 
| 
   insert  | 
  
   Specifies
  that the data is inserted into the workspace. Any data after the insertion
  point is moved forward in the workspace to make room. This is the default
  value.  | 
 
| 
   overwrite  | 
  
   Specifies
  that the data is copied into the workspace by writing over any existing data
  after the insertion point. The  insert  and  overwrite  flags affect whether
  frames are destroyed or moved during the paste operation, not how the data is
  pasted within each frame.  | 
 
| 
   to position  | 
  
   Specifies
  the position in the workspace at which the data is pasted. If omitted, it
  defaults to the current position.  | 
 
| 
   video
  stream stream  | 
  
   Specifies
  the video stream in the workspace affected by the command. 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  audio stream  flag. (If
  neither flag is specified, all audio and video streams are pasted and retain
  their original stream numbers.)   | 
 
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
No signals
are present in the data copied from the clipboard. The change becomes permanent
only when the data is explicitly saved; however, playback acts as if the data
has been added.