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