The EditStreamPaste function copies a stream (or a portion of it) from one stream and pastes it within another stream at a specified location.

STDAPI EditStreamPaste(
  PAVISTREAM pavi,     
  LONG * plPos,        
  LONG * plLength,     
  PAVISTREAM pstream,  
  LONG lStart,         
  LONG lLength         



Handle to an editable stream that will receive the copied stream data.


Starting position to paste the data within the destination stream (referenced by pavi).


Pointer to a buffer that receives the amount of data pasted in the stream.


Handle to a stream supplying the data to paste. This stream does not need to be an editable stream.


Starting position of the data to copy within the source stream.


Amount of data to copy from the source stream. If lLength is -1, the entire stream referenced by pstream is pasted in the other stream.

Return Values

Returns zero if successful or an error otherwise.


The stream referenced by pavi must have been created by the CreateEditableStream function or one of the stream editing functions.

This function inserts data into the specified stream as a continuous block of data. It opens the specified data stream at the insertion point, pastes the specified stream segment at the insertion point, and appends the stream segment that trails the insertion point to the end of pasted segment.


  Windows NT/2000/XP: Included in Windows NT 3.1 and later.
  Windows 95/98/Me: Included in Windows 95 and later.
  Header: Declared in Vfw.h.
  Library: Use Vfw32.lib.

See Also

AVIFile Functions and Macros, AVIFile Functions, CreateEditableStream

Positioning in Streams