aviSaveVA 函数 (vfw.h)

AVISaveV 函数通过组合来自其他文件或内存的数据流来生成文件。

语法

HRESULT AVISaveVA(
  LPCSTR               szFile,
  CLSID                *pclsidHandler,
  AVISAVECALLBACK      lpfnCallback,
  int                  nStreams,
  PAVISTREAM           *ppavi,
  LPAVICOMPRESSOPTIONS *plpOptions
);

参数

szFile

以 Null 结尾的字符串,其中包含要保存的文件的名称。

pclsidHandler

指向用于写入文件的文件处理程序的指针。 文件是使用此处理程序调用 AVIFileOpen 函数创建的。 如果未指定处理程序,则会根据文件扩展名从注册表中选择默认值。

lpfnCallback

指向回调函数的指针,该函数用于显示状态信息和让用户取消保存操作。

nStreams

要保存的流数。

ppavi

指向 指向 AVISTREAM 函数结构的指针数组的指针的指针。 数组对每个流使用一个指针。

plpOptions

指向 指向 AVICOMPRESSOPTIONS 结构的指针数组的指针的指针。 数组对每个流使用一个指针。

返回值

如果成功,则返回AVIERR_OK,否则返回错误。

注解

此函数等效于 AVISave 函数,只是流是在数组中传递的,而不是作为可变数量的参数传递的。

此函数创建文件,将流数据复制到文件中,关闭文件,并释放新文件使用的资源。 此函数的最后两个参数是数组,用于标识要保存在文件中的流并定义这些流的压缩选项。

应用程序必须为 AVICOMPRESSOPTIONS 结构和指向这些结构的指针数组分配内存。

参数 ppavi 包含指向 IAVIStream 接口的指针的地址。

注意

vfw.h 标头将 AVISaveV 定义为别名,该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将非特定编码别名与非非特定编码的代码混合使用可能会导致不匹配,从而导致编译或运行时错误。 有关详细信息,请参阅 函数原型的约定

要求

要求
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 vfw.h
Library Vfw32.lib
DLL Avifil32.dll

另请参阅

AVIFile 函数

AVIFile 函数和宏