AVISaveVW 函数 (vfw.h)

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

语法

HRESULT AVISaveVW(
  LPCWSTR              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 [仅限桌面应用]
目标平台 窗户
标头 vfw.h
Vfw32.lib
DLL Avifil32.dll

另请参阅

AVIFile 函数

AVIFile 函数和宏