ICCompressorChoose 函数 (vfw.h)

ICCompressorChoose 函数显示一个对话框,用户可以在其中选择压缩器。 此函数可以显示所有已注册的压缩器,也可以仅列出支持特定格式的压缩器。

语法

BOOL VFWAPI ICCompressorChoose(
  HWND      hwnd,
  UINT      uiFlags,
  LPVOID    pvIn,
  LPVOID    lpData,
  PCOMPVARS pc,
  LPSTR     lpszTitle
);

参数

hwnd

对话框的父窗口的句柄。

uiFlags

适用的标志。 定义了以下值。

含义
ICMF_CHOOSE_ALLCOMPRESSORS 所有压缩器都应显示在选择列表中。 如果未指定此标志,则只有可以处理输入格式的压缩器才会显示在选择列表中。
ICMF_CHOOSE_DATARATE 显示检查框和编辑框以输入电影的数据速率。
ICMF_CHOOSE_KEYFRAME 显示检查框和编辑框以输入关键帧的频率。
ICMF_CHOOSE_PREVIEW 显示一个按钮,用于展开对话框以包含预览窗口。 预览窗口显示使用当前设置进行压缩时电影帧的显示方式。

pvIn

未压缩的数据输入格式。 压缩器列表中仅包含支持指定数据输入格式的压缩器。 此参数是可选的。

lpData

指向在预览窗口中使用的 AVI 流接口的指针。 必须指定视频流。 此参数是可选的。

pc

指向 COMPVARS 结构的指针。 返回的信息初始化 结构以与其他函数一起使用。

lpszTitle

指向包含对话框标题的以 null 结尾的字符串的指针。 此参数可选。

返回值

如果用户选择压缩器并按“确定”,则返回 TRUE 。 如果出现错误或用户按 CANCEL,则返回 FALSE

注解

使用此函数之前,请将 COMPVARS 结构的 cbSize 成员设置为结构的大小。 除非要为对话框指定一些有效的默认值,否则将结构的其余部分初始化为零。 如果指定默认值,请将 dwFlags 成员设置为 ICMF_COMPVARS_VALID并初始化结构的其他成员。 有关初始化结构的详细信息,请参阅 ICSeqCompressFrameStart 函数和 COMPVARS

要求

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

另请参阅

视频压缩函数

视频压缩管理器