icm.h 标头

此标头由多种技术使用。 有关详细信息，请参阅：

• 打印 DDI 参考
• Windows 颜色系统

icm.h 包含以下编程接口：

函数

AssociateColorProfileWithDeviceA 将指定的颜色配置文件与指定的设备相关联。 (ANSI)
AssociateColorProfileWithDeviceW 将指定的颜色配置文件与指定的设备相关联。 (Unicode)
CheckBitmapBits 检查指定位图中的像素是否位于指定转换的输出 范围内 。
CheckColors 确定数组中的颜色是否位于指定转换的输出 范围 内。
CloseColorProfile 关闭打开的配置文件句柄。
CMCheckColors 确定给定颜色是否位于指定转换的输出 范围 中。
CMCheckColorsInGamut 确定指定的 RGB 三重是否位于指定转换的输出 范围 中。
CMCheckRGBs 根据输出范围检查位图颜色。
CMConvertColorNameToIndex 将命名颜色空间中的颜色名称转换为颜色配置文件中的索引号。
CMConvertIndexToColorName 将颜色空间中的索引转换为命名颜色空间中的名称数组。 (CMConvertIndexToColorName)
CMCreateDeviceLinkProfile 按照国际颜色联盟在其 ICC 配置文件格式规范中指定的格式创建 设备链接 配置文件。
CMCreateMultiProfileTransform 接受配置文件数组或单个 设备链接配置文件 ，并创建颜色转换。 此转换是从第一个配置文件指定的颜色空间到第二个配置文件的颜色空间的映射，依此类图映射到最后一个配置文件。
CMCreateProfile 从 LOGCOLORSPACEA 结构创建显示颜色配置文件。
CMCreateProfileW 从 LOGCOLORSPACEW 结构创建显示颜色配置文件。
CMCreateTransform 已弃用。 没有替换 API，因为不再使用此 API。 不需要备用 CMM 模块的开发人员来实现它。 (CMCreateTransform)
CMCreateTransformExt 使用一组定义应如何创建转换的标志创建颜色转换，该转换从输入 LOGCOLORSPACEA 映射到可选目标空间，然后映射到输出设备。
CMCreateTransformExtW 使用一组定义应如何创建转换的标志创建颜色转换，该转换从输入 LOGCOLORSPACEW 映射到可选目标空间，然后映射到输出设备。
CMCreateTransformW 已弃用。 没有替换 API，因为不再使用此 API。 不需要备用 CMM 模块的开发人员来实现它。 (CMCreateTransformW)
CMDeleteTransform 删除指定的颜色转换，并释放与其关联的任何内存。
CMGetInfo 检索有关颜色管理模块 (CMM) 的各种信息。
CMGetNamedProfileInfo 检索有关指定命名颜色配置文件的信息。
CMGetPS2ColorRenderingDictionary 将确定 CMGetPS2ColorRenderingDictionary 及其关联的其他参数。
CMGetPS2ColorRenderingIntent 从配置文件中检索 PostScript 级别 2 颜色 呈现意向 。
CMGetPS2ColorSpaceArray CMGetPS2ColorSpaceArray 以及与其关联的参数、返回和注释需要确定。
CMIsProfileValid 报告给定配置文件是否是可用于颜色管理的有效 ICC 配置文件。
CMTranslateColors 使用颜色转换将颜色数组从源 颜色空间 转换为目标颜色空间。
CMTranslateRGB 将应用程序提供的 RGBQuad 转换为设备 颜色空间。
CMTranslateRGBs 使用颜色转换将位图从一个 颜色空间 转换为另一个颜色空间。
CMTranslateRGBsExt 将位图从一种定义的格式转换为不同的已定义格式，并定期调用回调函数（如果指定了一个），以报告进度并允许调用应用程序终止转换。
ColorProfileAddDisplayAssociation ColorProfileAddDisplayAssociation 将已安装的颜色配置文件与给定范围内指定的显示器相关联。
ColorProfileGetDisplayDefault ColorProfileGetDisplayDefault 获取指定范围内给定显示器的默认颜色配置文件。
ColorProfileGetDisplayList ColorProfileGetDisplayList 检索与指定范围内给定显示器关联的配置文件列表。
ColorProfileGetDisplayUserScope ColorProfileGetDisplayUserScope 获取所提供显示器的当前所选颜色配置文件范围 - 用户或系统。
ColorProfileRemoveDisplayAssociation ColorProfileRemoveDisplayAssociation 从给定范围中的指定显示器取消关联已安装的颜色配置文件。
ColorProfileSetDisplayDefaultAssociation ColorProfileSetDisplayDefaultAssociation 将已安装的颜色配置文件设置为给定范围内指定显示的默认配置文件。
ConvertColorNameToIndex 将命名颜色空间中的颜色名称转换为国际颜色联盟 (ICC) 颜色配置文件中的索引号。
ConvertIndexToColorName 将颜色空间中的索引转换为命名颜色空间中的名称数组。 (ConvertIndexToColorName)
CreateColorTransformA 创建应用程序可用于执行颜色管理的颜色转换。 (ANSI)
CreateColorTransformW 创建应用程序可用于执行颜色管理的颜色转换。 (Unicode)
CreateDeviceLinkProfile 使用指定的意向从一组颜色配置文件创建国际颜色联盟 (ICC) 设备链接 配置文件。
CreateMultiProfileTransform 接受配置文件数组或单个 设备链接配置文件 ，并创建应用程序可用于执行颜色映射的颜色转换。
CreateProfileFromLogColorSpaceA 将逻辑 颜色空间 转换为 设备配置文件。 (ANSI)
CreateProfileFromLogColorSpaceW 将逻辑 颜色空间 转换为 设备配置文件。 (Unicode)
DeleteColorTransform 删除给定的颜色转换。
DisassociateColorProfileFromDeviceA 取消指定颜色配置文件与指定计算机上的指定设备的关联。 (ANSI)
DisassociateColorProfileFromDeviceW 取消指定颜色配置文件与指定计算机上的指定设备的关联。 (Unicode)
EnumColorProfilesA 枚举满足给定枚举条件的所有配置文件。 (ANSI)
EnumColorProfilesW 枚举满足给定枚举条件的所有配置文件。 (Unicode)
GetCMMInfo 检索有关颜色管理模块 (创建指定颜色转换的 CMM) 的各种信息。
GetColorDirectoryA 检索指定计算机上的 Windows COLOR 目录的路径。 (ANSI)
GetColorDirectoryW 检索指定计算机上的 Windows COLOR 目录的路径。 (Unicode)
GetColorProfileElement 将数据从指定颜色配置文件的指定标记配置文件元素复制到缓冲区中。
GetColorProfileElementTag 检索给定国际颜色联盟的标记表中 dwIndex 指定的标记名称， (ICC) 颜色配置文件，其中 dwIndex 是该表中的从 1 开始的索引。
GetColorProfileFromHandle 给定打开的颜色配置文件的句柄， GetColorProfileFromHandle 函数会将配置文件的内容复制到应用程序提供的缓冲区中。 如果句柄是 Windows 颜色系统 (WCS) 句柄，则返回 DMP 并忽略与 HPROFILE 关联的 CAMP 和 GMMP。
GetColorProfileHeader 从 ICC 颜色配置文件或 WCS XML 配置文件检索或派生 ICC 标头结构。 驱动程序和应用程序应假定返回 TRUE 仅指示返回结构正确的标头。 仍需使用旧版 ICM2 API 或 XML 架构 API 独立验证每个标记。
GetCountColorProfileElements 检索给定颜色配置文件中标记的元素数。
GetNamedProfileInfo 检索有关国际颜色联盟 (ICC) 在第一个参数中指定的命名颜色配置文件的信息。
GetPS2ColorRenderingDictionary 从指定的 ICC 颜色配置文件中检索 PostScript 级别 2 颜色呈现字典。
GetPS2ColorRenderingIntent 从 ICC 颜色配置文件中检索 PostScript 级别 2 颜色 呈现意向 。
GetPS2ColorSpaceArray 从 ICC 颜色配置文件中检索 PostScript 级别 2 颜色 空间 数组。
GetStandardColorSpaceProfileA 检索为指定的标准颜色 空间注册的颜色配置文件。 (ANSI)
GetStandardColorSpaceProfileW 检索为指定的标准颜色 空间注册的颜色配置文件。 (Unicode)
InstallColorProfileA 安装给定的配置文件，以便在指定的计算机上使用。 配置文件也会复制到 COLOR 目录。 (ANSI)
InstallColorProfileW 安装给定的配置文件，以便在指定的计算机上使用。 配置文件也会复制到 COLOR 目录。 (Unicode)
IsColorProfileTagPresent 报告指定的国际颜色联盟 (ICC) 标记是否存在于指定的颜色配置文件中。
IsColorProfileValid 允许确定指定的配置文件是有效的国际颜色联盟 (ICC) 配置文件，还是可用于颜色管理的有效 Windows 颜色系统 (WCS) 配置文件句柄。
OpenColorProfileA 创建指定颜色配置文件的句柄。 然后，可以在其他配置文件管理功能中使用句柄。 (ANSI)
OpenColorProfileW 创建指定颜色配置文件的句柄。 然后，可以在其他配置文件管理功能中使用句柄。 (Unicode)
RegisterCMMA 将指定的标识值与指定的颜色管理模块动态链接库关联 (CMM DLL) 。 当此 ID 出现在颜色配置文件中时，Windows 随后可以找到相应的 CMM 以创建转换。 (ANSI)
RegisterCMMW 将指定的标识值与指定的颜色管理模块动态链接库关联 (CMM DLL) 。 当此 ID 出现在颜色配置文件中时，Windows 随后可以找到相应的 CMM 以创建转换。 (Unicode)
SelectCMM 允许选择首选颜色管理模块 (CMM) 。
SetColorProfileElement 设置 ICC 颜色配置文件中标记的配置文件元素的元素数据。
SetColorProfileElementReference 在指定的 ICC 颜色配置文件中创建引用与现有标记相同的数据的新标记。
SetColorProfileElementSize 设置 ICC 颜色配置文件中标记的元素的大小。
SetColorProfileHeader 在指定的 ICC 颜色配置文件中设置标头数据。
SetStandardColorSpaceProfileA 为给定的标准 颜色空间注册指定的配置文件。 可以使用 GetStandardColorSpaceProfileW 查询配置文件。 (ANSI)
SetStandardColorSpaceProfileW 为给定的标准 颜色空间注册指定的配置文件。 可以使用 GetStandardColorSpaceProfileW 查询配置文件。 (Unicode)
SetupColorMatchingA 创建颜色管理对话框，允许用户选择是否启用颜色管理，如果启用，则提供对所用颜色配置文件和 呈现意向的控制。 (ANSI)
SetupColorMatchingW 创建颜色管理对话框，允许用户选择是否启用颜色管理，如果启用，则提供对所用颜色配置文件和 呈现意向的控制。 (Unicode)
TranslateBitmapBits 转换具有定义格式的位图的颜色，以便以请求的格式生成另一个位图。
TranslateColors 根据颜色转换的定义，将源 颜色空间中的颜色 数组转换为目标颜色空间。
UninstallColorProfileA 从指定计算机中删除指定的颜色配置文件。 可以选择从系统中删除关联的文件。 (ANSI)
UninstallColorProfileW 从指定计算机中删除指定的颜色配置文件。 可以选择从系统中删除关联的文件。 (Unicode)
UnregisterCMMA 将指定的 ID 值与给定的颜色管理模块动态链接库取消关联， (CMM DLL) 。 (ANSI)
UnregisterCMMW 将指定的 ID 值与给定的颜色管理模块动态链接库取消关联， (CMM DLL) 。 (Unicode)
WcsAssociateColorProfileWithDevice WcsAssociateColorProfileWithDevice 将指定的 WCS 颜色配置文件与指定的设备相关联。
WcsCheckColors 确定数组中的颜色是否在指定 WCS 颜色转换的输出色域内。
WcsCreateIccProfile 将 WCS 配置文件转换为国际颜色联盟 (ICC) 配置文件。
WcsDisassociateColorProfileFromDevice 从计算机上的指定设备取消关联指定的 WCS 颜色配置文件。
WcsEnumColorProfiles 枚举满足指定配置文件管理范围中枚举条件的所有颜色配置文件。
WcsEnumColorProfilesSize 返回 WcsEnumColorProfiles 函数枚举颜色配置文件所需的缓冲区的大小（以字节为单位）。
WcsGetCalibrationManagementState 确定是否启用对显示器校准状态的系统管理。
WcsGetDefaultColorProfile 检索设备的默认颜色配置文件，如果未指定设备，则检索与设备无关的默认值。
WcsGetDefaultColorProfileSize 返回设备的默认颜色配置文件名称的大小（以字节为单位）， (包括 NULL 终止符) 。
WcsGetDefaultRenderingIntent 检索指定配置文件管理范围中的默认呈现意向。
WcsGetUsePerUserProfiles 确定用户是否选择对指定设备使用每用户配置文件关联列表。
WcsOpenColorProfileA 创建指定颜色配置文件的句柄。 (ANSI)
WcsOpenColorProfileW 创建指定颜色配置文件的句柄。 (Unicode)
WcsSetCalibrationManagementState 启用或禁用显示校准状态的系统管理。
WcsSetDefaultColorProfile 设置指定配置文件管理范围内指定配置文件类型的默认颜色配置文件名称。
WcsSetDefaultRenderingIntent 在指定的配置文件管理范围内设置默认呈现意向。
WcsSetUsePerUserProfiles 使用户能够指定是否对指定设备使用每用户配置文件关联列表。
WcsTranslateColors 根据颜色转换的定义，将源颜色空间中的颜色数组转换为目标颜色空间。

回调函数

PBMCALLBACKFN TBD (PBMCALLBACKFN)
PCMSCALLBACKA *PCMSCALLBACKA* (或 ApplyCallbackFunction) 是一个回调函数，在 SetupColorMatchingW 函数显示的对话框正在执行时，该回调函数将更新 WCS 配置数据。
PCMSCALLBACKW *PCMSCALLBACKW* (或 ApplyCallbackFunction) 是你实现的回调函数，可在 SetupColorMatchingW 函数显示的对话框执行时更新 WCS 配置数据。

结构

CMYKCOLOR CMYKCOLOR 结构的说明。
颜色 颜色联合的说明。
COLORMATCHSETUPA COLORMATCHSETUP 结构包含 SetupColorMatchingW 函数用于初始化 ColorManagement 对话框的信息。 (ANSI)
COLORMATCHSETUPW COLORMATCHSETUP 结构包含 SetupColorMatchingW 函数用于初始化 ColorManagement 对话框的信息。 (Unicode)
ENUMTYPEA 包含定义配置文件枚举约束的信息。 (ANSI)
ENUMTYPEW 包含定义配置文件枚举约束的信息。 (Unicode)
GENERIC3CHANNEL TBD (GENERIC3CHANNEL)
GRAYCOLOR GRAYCOLOR 结构的说明。
HiFiCOLOR HiFiCOLOR 结构的说明。
LabCOLOR TBD (LabCOLOR)
NAMED_PROFILE_INFO NAMED_PROFILE_INFO结构用于存储有关命名颜色配置文件的信息。
NAMEDCOLOR TBD (NAMEDCOLOR)
配置 文件 包含定义颜色配置文件的信息。
PROFILEHEADER 包含描述设备配置文件内容的信息。 此标头出现在设备配置文件的开头。
RGBCOLOR TBD (RGBCOLOR)
XYZCOLOR TBD (XYZCOLOR)
YxyCOLOR TBD (YxyCOLOR)

枚举

BMFORMAT 多个 WCS 函数使用 BMFORMAT 枚举类型的值来指示特定位图的格式。
COLORDATATYPE 由 WCS 函数用来指示向量内容的数据类型。
COLORPROFILESUBTYPE 指定颜色配置文件的子类型。
COLORPROFILETYPE 指定颜色配置文件的类型。
COLORTYPE COLORTYPE 枚举的值由多个 WCS 函数使用。 COLOR 类型的变量在 COLORTYPE 枚举枚举的颜色空间中定义。
WCS_PROFILE_MANAGEMENT_SCOPE 指定配置文件管理操作的范围，例如将配置文件与设备关联。