cmCheckColors 函数 (icm.h)

  • 项目

确定给定颜色是否位于指定转换的输出 范围 中。

语法

BOOL CMCheckColors(
  HCMTRANSFORM hcmTransform,
  LPCOLOR      lpaInputColors,
  DWORD        nColors,
  COLORTYPE    ctInput,
  LPBYTE       lpaResult
);

parameters

hcmTransform

要使用的颜色转换的句柄。

lpaInputColors

指向要针对输出范围检查 COLOR 结构的数组的指针。

nColors

指定数组中元素的数目。

ctInput

指定输入颜色类型。

lpaResult

指向要在其中放置包含测试结果的字节数组的缓冲区的指针。 缓冲区中的每个字节对应于 COLOR 结构，退出时已设置为 0 到 255 之间的无符号值。 值 0 表示颜色处于色域，而非零值表示该颜色已超过色域。 对于任何整数 n ，如 0 <n< 255，结果值 n + 1 指示相应的颜色至少与结果值 n 表示的色域一样远。 这些值通常是从 ICC 配置文件中的 gamutTag 生成的。

返回值

如果此函数成功，则返回值为 TRUE。

如果此函数失败，则返回值为 FALSE。 如果函数不成功，CMM 应调用 SetLastError ，将最后一个错误设置为 Winerror.h 中定义的有效错误值。

注解

导出此函数需要每个 CMM。

如果输入颜色类型与颜色转换不兼容， 则 CMCheckColors 将失败。

要求

   
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
标头 icm.h

另请参阅