AVIFileCreateStream

The AVIFileCreateStream function creates a new stream in an existing file and creates an interface to the new stream.

STDAPI AVIFileCreateStream(
  PAVIFILE pfile,      
  PAVISTREAM * ppavi,  
  AVISTREAMINFO * psi  
);
 

Parameters

pfile

Handle of an open AVI file.

ppavi

Address of the new stream interface.

psi

Address of a structure containing information about the new stream, including the stream type and its sample rate.

Return Values

Returns zero if successful or an error otherwise. Unless the file has been opened with write permission, this function returns AVIERR_READONLY.

Remarks

This function starts a reference count for the new stream.

QuickInfo

  Windows NT: Requires version 3.1 or later.
  Windows: Requires Windows 95 or later.
  Windows CE: Unsupported.
  Header: Declared in vfw.h.
  Import Library: Use vfw32.lib.
  Unicode: Implemented as Unicode and ANSI versions on Windows NT.

See Also

AVIFile Functions and Macros Overview, AVIFile Functions