GetColorProfileFromHandle 函数 (icm.h)

给定打开的颜色配置文件的句柄， GetColorProfileFromHandle 函数会将配置文件的内容复制到应用程序提供的缓冲区中。 如果句柄是 Windows 颜色系统 (WCS) 句柄，则返回 DMP 并忽略与 HPROFILE 关联的 CAMP 和 GMMP。

语法

BOOL GetColorProfileFromHandle(
  HPROFILE hProfile,
  PBYTE    pProfile,
  PDWORD   pcbProfile
);

parameters

hProfile

打开的颜色配置文件的句柄。 函数确定 HPROFILE 是否包含 ICC 或 WCS 配置文件信息。

pProfile

指向用于接收原始 ICC 或 DMP 配置文件数据的缓冲区的指针。 可以为 NULL。 如果是，缓冲区所需的大小将存储在 由Size 指向的内存位置中。 可以将缓冲区分配到适当的大小，并且此函数再次调用包含缓冲区地址的 pBuffer 。

pcbProfile

指向保存 pBuffer 指向的缓冲区大小的 DWORD 的指针。 返回时，如果函数成功，则用实际使用的缓冲区大小填充它。 如果在 pBuffer 设置为 NULL 的情况下调用此函数，则此参数将包含所需缓冲区的大小。

返回值

如果此函数成功，则返回值为 TRUE。 如果 pBuffer 参数为 NULL，并且缓冲区所需的大小复制到了码Size 中，则返回 FALSE。

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

要求

另请参阅

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