AVIMakeFileFromStreams

  • Article

The AVIMakeFileFromStreams function constructs an AVIFile interface pointer from separate streams.

STDAPI AVIMakeFileFromStreams(
  PAVIFILE * ppfile,       
  int nStreams,            
  PAVISTREAM * papStreams  
);

Parameters

ppfile

Pointer to a buffer that receives the new file interface pointer.

nStreams

Count of the number of streams in the array of stream interface pointers referenced by papStreams.

papStreams

Pointer to an array of stream interface pointers.

Return Values

Returns zero if successful or an error otherwise.

Remarks

Use the AVIFileRelease function to close the file.

Other functions can use the AVIFile interface created by this function to copy and edit the streams associated with the interface. For example, you can retrieve a specific stream by using AVIFileGetStream with the file interface pointer.

The argument pfile is the address of a pointer to an IAVIFile interface. The argument papStreams is the address of 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.

See Also

AVIFile Functions and Macros, AVIFile Functions, AVIFileRelease, AVIFileGetStream