EditStreamPaste

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         
);

Parameters

pavi

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

plPos

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

plLength

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

pstream

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

lStart

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

lLength

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.

Remarks

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.

Requirements

  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

Show: