Share via

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_OK;如果用户希望中止保存操作，则AVIERR_USERABORT。

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

注意

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

要求

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

另请参阅

AVIFile 函数

AVIFile 函数和宏