Share via


EditStreamCut

The EditStreamCut function deletes all or part of an editable stream and creates a temporary editable stream from the deleted portion of the stream.

STDAPI EditStreamCut(
  PAVISTREAM pavi,       
  LONG * plStart,        
  LONG * plLength,       
  PAVISTREAM * ppResult  
);

Parameters

pavi

Handle to the stream being edited.

plStart

Starting position of the data to cut from the stream referenced by pavi.

plLength

Amount of data to cut from the stream referenced by pavi.

ppResult

Pointer to the handle created for the new stream.

Return Values

Returns zero if successful or an error otherwise.

Remarks

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

The temporary stream is an editable stream and can be treated as any other AVI stream. An application must release the temporary stream to free the resources associated with it.

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