通过

AVISaveA 函数 （vfw.h）

  • 项目

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

语法

HRESULT AVISaveA(
  LPCSTR               szFile,
  CLSID                *pclsidHandler,
  AVISAVECALLBACK      lpfnCallback,
  int                  nStreams,
  PAVISTREAM           pfile,
  LPAVICOMPRESSOPTIONS lpOptions,
  ...                  
);

参数

szFile

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

pclsidHandler

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

lpfnCallback

指向保存操作的回调函数的指针。

nStreams

文件中保存的流数。

pfile

指向 AVI 流的指针。 此参数与 lpOptions配对。 参数对可以重复为可变数量的参数。

lpOptions

指向应用程序定义的 AVICOMPRESSOPTIONS 结构的指针，该结构包含由 pavi引用的流的压缩选项。 此参数与 pavi 配对。 参数对可以重复为可变数量的参数。

...

返回值

如果成功或错误，则返回AVIERR_OK。

言论

此函数创建一个文件，将流数据复制到文件中，关闭该文件，并释放新文件使用的资源。 此函数的最后两个参数标识要在文件中保存的流，并定义该流的压缩选项。 在 AVI 文件中保存多个流时，请对文件中的每个流重复这两个特定于流的参数。

回调函数（使用 lpfnCallback引用）可以显示状态信息，并允许用户取消保存操作。 回调函数使用以下格式：


LONG PASCAL SaveCallback(int nPercent)

nPercent 参数指定已保存文件的百分比。

如果操作应继续，并且如果用户希望中止保存操作，则回调函数应返回 AVIERR_USERABORT AVIERR_OK。

pavi 参数 是指向 IAVIStream 接口的指针。

注意

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

要求

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

另请参阅

AVIFile 函数

AVIFile 函数和宏