AVIFileCreateStream function

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

Syntax

HRESULT 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 Value

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 version Windows 2000 Professional [desktop apps only] Windows 2000 Server [desktop apps only]
Target Platform Windows
Header vfw.h
Library Vfw32.lib
DLL Avifil32.dll

See Also

AVIFile Functions

AVIFile Functions and Macros

AVIStreamInfo