GetColorProfileElement 函数 (icm.h)

  • 项目

将数据从指定颜色配置文件的指定标记配置文件元素复制到缓冲区中。

语法

BOOL GetColorProfileElement(
  HPROFILE hProfile,
  TAGTYPE  tag,
  DWORD    dwOffset,
  PDWORD   pcbElement,
  PVOID    pElement,
  PBOOL    pbReference
);

parameters

hProfile

指定国际颜色联盟 (ICC) 有关颜色配置文件的句柄。

tag

标识要从中复制的标记元素。

dwOffset

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

pcbElement

指向指定要复制的字节数的变量的指针。 返回时，变量包含实际复制的字节数。

pElement

指向要向其复制标记元素数据的缓冲区的指针。 缓冲区包含的字节数必须至少与 由“印刷”Size 指向的变量所指定的字节数相同。 如果 pBuffer 指针设置为 NULL，则会在 由 pcSize 指向的内存位置返回整个标记元素数据的大小（以字节为单位），并忽略 dwOffset 。 在这种情况下，函数将返回 FALSE。

pbReference

指向设置为 TRUE 的布尔值，如果颜色配置文件中的多个标记引用与指定标记引用的数据相同，则指向 设置为 TRUE ;如果不是，则为 FALSE。

返回值

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

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

注解

如果 hProfile 不是有效的国际颜色联盟 (ICC) 配置文件，则此函数将失败。

如果 pBuffer 指针设置为 NULL，则以字节为单位的整个标记元素数据的大小将在 由印刷机 指向的变量中返回，并忽略 dwOffset 。

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

要求

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

另请参阅