AVISaveV

The AVISaveV function builds a file by combining data streams from other files or from memory.

STDAPI AVISaveV(
  LPCTSTR szFile,                
  CLSID * pclsidHandler,         
  AVISAVECALLBACK lpfnCallback,  
  int nStreams,                  
  PAVISTREAM * ppavi,            
  LPAVICOMPRESSOPTIONS * plpOptions  
);
 

Parameters

szFile

Null-terminated string containing the name of the file to save.

pclsidHandler

Address of the file handler used to write the file. The file is created by calling the AVIFileOpen function using this handler. If a handler is not specified, a default is selected from the registry based on the file extension.

lpfnCallback

Address of a callback function used to display status information and to let the user cancel the save operation.

nStreams

Number of streams to save.

ppavi

Address of an array of pointers to the AVISTREAM function structures. The array uses one pointer for each stream.

plpOptions

Address of an array of pointers to AVICOMPRESSOPTIONS structures. The array uses one pointer for each stream.

Return Values

Returns AVIERR_OK if successful or an error otherwise.

Remarks

This function is equivalent to the AVISave function except the streams are passed in an array instead of as a variable number of arguments.

This function creates a file, copies stream data into the file, closes the file, and releases the resources used by the new file. The last two parameters of this function are arrays that identify the streams to save in the file and define the compression options of those streams.

An application must allocate memory for the AVICOMPRESSOPTIONS structures and the array of pointers to these structures.

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, AVIFileOpen, AVICOMPRESSOPTIONS, AVISave