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 运算符的操作数。

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