CMCheckColorsInGamut 函数 (icm.h)

[从 Windows Vista 起，CMCheckColorsInGamut 不再可供使用。]

确定指定的 RGB 三元是否位于指定转换的输出 色域 中。

语法

BOOL CMCheckColorsInGamut(
  HCMTRANSFORM hcmTransform,
  RGBTRIPLE    *lpaRGBTriple,
  LPBYTE       lpaResult,
  UINT         nCount
);

参数

hcmTransform

指定要使用的转换。

lpaRGBTriple

指向 RGB 三元数组以检查。

lpaResult

指向要在其中放置结果的缓冲区。

结果由字节数组表示。 数组中的每个字节对应于一个 RGB 三元，并且具有介于 0 和 255 之间的无符号值。 值 0 表示颜色在色域中，而非零值表示它已脱离色域。 对于范围 0 <n 255 中的任何整数 n<，结果值 n + 1 表示相应的颜色至少与结果值 n 表示的色域一样远。

nCount

指定数组中元素的数目。

返回值

从 Windows Vista 开始，默认 CMM (Icm32.dll) 将返回 FALSE，GetLastError 将报告ERROR_NOT_SUPPORTED。

Windows Server 2003、Windows XP 和 Windows 2000：

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

如果此函数失败，则返回值为 FALSE。 调用 GetLastError 以检索错误。

注解

从 Windows Vista 开始，不再需要 CMM 实现程序来实现此方法。

Windows Server 2003、Windows XP 和 Windows 2000：

实现此方法需要 CMM 实现程序。

导出此函数需要每个 CMM。

如果函数不成功，自定义 CMM 应调用 SetLastError ，将上一个错误设置为 Winerror.h 中定义的有效错误值。

要求

另请参阅

• 基本颜色管理概念
• 函数