setColorProfileElement 函数 (icm.h)

设置 ICC 颜色配置文件中标记的配置文件元素的元素数据。

语法

BOOL SetColorProfileElement(
  HPROFILE hProfile,
  TAGTYPE  tag,
  DWORD    dwOffset,
  PDWORD   pcbElement,
  PVOID    pElement
);

参数

hProfile

指定有问题的 ICC 配置文件的句柄。

tag

标识标记的元素。

dwOffset

指定要开始写入的标记元素数据的第一个字节的偏移量。

pcbElement

指向包含要写入的数据字节数的变量的指针。 返回时，它包含实际写入的字节数。

pElement

指向缓冲区的指针，该缓冲区包含要写入颜色配置文件中标记元素的数据。

返回值

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

如果此函数失败，则返回值为 FALSE。 有关扩展的错误信息，请调用 GetLastError。

注解

如果 hProfile 不是有效的 ICC 配置文件，则此函数将失败。

如果未打开颜色配置文件以获取读/写权限，则此函数将失败。

如果 dwOffset 超出指定标记元素设置的大小，则此函数将失败。

如果 dwOffset + *bsize 大于指定元素的大小，则此函数只写入元素当前大小的字节数。

当此函数成功时，将覆盖已标记元素的指定部分中的任何现有数据。

此函数不支持 Windows 颜色系统 (WCS) 配置文件 CAMP、DMP 和 GMMP;因为配置文件元素与 ICC 标记类型隐式关联并硬编码，并且存在许多可靠的 XML 分析库。

要求

另请参阅

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