ICImageCompress 函数 (vfw.h)

ICImageCompress 函数将图像压缩为给定大小。 此函数不需要初始化函数。

语法

HANDLE VFWAPI ICImageCompress(
  HIC          hic,
  UINT         uiFlags,
  LPBITMAPINFO lpbiIn,
  LPVOID       lpBits,
  LPBITMAPINFO lpbiOut,
  LONG         lQuality,
  LONG         *plSize
);

参数

hic

使用 ICOpen 函数打开的压缩器的句柄。 指定 NULL 可让 VCM 为压缩格式选择适当的压缩器。 应用程序可以让用户使用 ICCompressorChoose 函数选择压缩器,这将打开所选压缩器并在此参数中返回压缩器的句柄。

uiFlags

保留;必须为零。

lpbiIn

指向包含输入数据格式的 BITMAPINFO 结构的指针。

lpBits

指向要压缩的输入数据位的指针。 数据位排除标头和格式信息。

lpbiOut

指向包含压缩输出格式的 BITMAPINFO 结构的指针。 指定 NULL 以让压缩器使用适当的格式。

lQuality

压缩器使用的质量值。 值的范围从 0 到 10,000。

plSize

压缩图像所需的最大大小。 压缩器可能无法压缩数据以适应此大小。 函数返回时,此参数指向压缩图像的大小。 图像大小以字节为单位指定。

返回值

返回压缩 DIB 的句柄。 图像数据遵循格式标头。

注解

若要从 BITMAPINFOHEADER 结构获取格式信息,请使用 GlobalLock 函数锁定数据。 完成后,使用 GlobalFree 函数释放 DIB。

要求

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

另请参阅

视频压缩函数

视频压缩管理器