AVIFileCreateStream

  • Article

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 to an open AVI file.

ppavi

Pointer to the new stream interface.

psi

Pointer to 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.

The argument pfile is a pointer to an IAVIFile interface. The argument ppavi is a pointer to an IAVIStream interface.

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.
**  Unicode:** Implemented as Unicode and ANSI versions on Windows NT/2000/XP.

See Also

AVIFile Functions and Macros, AVIFile Functions, AVIStreamInfo