cmGetPS2ColorRenderingIntent 函数 (icm.h)

从配置文件中检索 PostScript 级别 2 颜色呈现意向。

语法

BOOL CMGetPS2ColorRenderingIntent(
  HPROFILE hProfile,
  DWORD    dwIntent,
  LPBYTE   lpBuffer,
  LPDWORD  lpcbSize
);

参数

hProfile

指定要使用的配置文件。

dwIntent

指定要检索的所需呈现意向。 可以是以下其中一个值：

INTENT_PERCEPTUAL
INTENT_SATURATION
INTENT_RELATIVE_COLORIMETRIC
INTENT_ABSOLUTE_COLORIMETRIC

有关详细信息，请参阅 呈现意向。

lpBuffer

指向要在其中放置颜色呈现意向的缓冲区。 如果指针为 NULL，则该函数将返回此缓冲区所需的大小 （位于 *lsize 中）。

lpcbSize

指向指定缓冲区大小的变量。 返回时，变量包含具有实际复制到缓冲区的字节数。

返回值

如果此函数成功，则返回值为 TRUE。 如果在 将 lpBuffer 设置为 NULL 的情况下调用，并且所需缓冲区的大小复制到 l或者size 中，则它还返回 TRUE。

如果此函数失败，则返回值为 FALSE。 发生这种情况时，CMM 应调用 SetLastError ，将最后一个错误设置为 Winerror.h 中定义的有效错误值。

注解

此函数对于所有 CMM 都是可选的。

如果 CMM 不支持此函数，Windows 将使用默认 CMM 来获取颜色呈现意向。

如果 hProfile 指示的配置文件中不存在标记，则 CMM 会创建它。 生成的呈现意向可用作 PostScript 级别 2 findcolorrendering 运算符的操作数。

要求

另请参阅

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