ICLocate 函数 (vfw.h)

ICLocate 函数查找可以处理具有指定格式的图像的压缩器或解压缩器,或查找可将具有指定格式的图像直接解压缩到硬件的驱动程序。

语法

HIC VFWAPI ICLocate(
  DWORD              fccType,
  DWORD              fccHandler,
  LPBITMAPINFOHEADER lpbiIn,
  LPBITMAPINFOHEADER lpbiOut,
  WORD               wFlags
);

参数

fccType

指示要打开的压缩器或解压缩器类型的四个字符代码。 对于视频流,此参数的值为“VIDC”。

fccHandler

指定类型的首选处理程序。 通常,处理程序类型存储在 AVI 文件的流标头中。 如果应用程序可以使用任何处理程序类型,或者它不知道要使用的处理程序类型,请指定 NULL

lpbiIn

指向用于定义输入格式的 BITMAPINFOHEADER 结构的指针。 除非它支持此格式,否则不会返回压缩器句柄。

lpbiOut

指向用于定义可选解压缩格式的 BITMAPINFOHEADER 结构的指针。 还可以指定零以使用与输入格式关联的默认输出格式。

如果此参数为非零,则不会返回压缩器句柄,除非它可以创建此输出格式。

wFlags

描述压缩器或解压缩器的搜索条件的标志。 定义了以下值:

含义
ICMODE_COMPRESS
查找一个压缩器,该压缩器可以使用 lpbiIn 定义的格式将图像压缩为 lpbiOut 定义的格式。
ICMODE_DECOMPRESS
查找一个解压缩程序,该解压缩程序可以使用 lpbiIn 定义的格式将图像解压缩为 lpbiOut 定义的格式。
ICMODE_DRAW
查找一个解压缩器,该解压缩器可以使用 lpbiIn 定义的格式解压缩图像,并将其直接绘制到硬件。
ICMODE_FASTCOMPRESS
具有与 ICMODE_COMPRESS 的含义相同,但压缩器用于实时操作,并强调速度比质量。
ICMODE_FASTDECOMPRESS
具有与 ICMODE_DECOMPRESS 的含义相同,但解压缩器用于实时操作,并强调速度比质量。

返回值

如果成功,则返回压缩器或解压缩器的句柄,否则返回零。

要求

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

另请参阅

视频压缩函数

视频压缩管理器