WcsOpenColorProfileW 函数 (icm.h)

创建指定颜色配置文件的句柄。

语法

HPROFILE WcsOpenColorProfileW(
  PPROFILE pCDMPProfile,
  PPROFILE pCAMPProfile,
  PPROFILE pGMMPProfile,
  DWORD    dwDesireAccess,
  DWORD    dwShareMode,
  DWORD    dwCreationMode,
  DWORD    dwFlags
);

参数

pCDMPProfile

指向指定配置文件的 WCS DMP 或 ICC 颜色配置文件结构的指针。 创建句柄后，可以释放 pCDMPProfile 指针。 如果配置文件是 ICC，并且其 dwType 成员设置为 DONT_USE_EMBEDDED_WCS_PROFILES， 则 WcsOpenColorProfile 将忽略 ICC 配置文件中的任何嵌入式 WCS 配置文件。

pCAMPProfile

指向配置文件结构的指针，该结构指定 WCS 颜色外观模型配置文件 (CAMP) 。 创建句柄后，可以释放 pCAMPProfile 指针。 如果 为 NULL，则使用默认 CAMP，在查询默认 CAMP 时使用当前用户设置WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER。

pGMMPProfile

指向配置文件结构的指针，该结构指定 GMMP) (WCS 域映射模型配置文件。 创建句柄后，可以释放 pGMMPProfile 指针。 如果 为 NULL，则使用默认呈现意向的默认 GMMP，在查询默认 GMMP 时使用当前用户设置（WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER）。 有关呈现意向的说明，请参阅 呈现意向。

dwDesireAccess

一个标志值，该值指定如何访问指定的颜色配置文件。 此参数必须采用以下值之一：

dwShareMode

一个标志值，该值指定在打开文件中包含的颜色配置文件时要执行的操作。 此参数必须采用以下值之一，这些值在 winnt.h 中定义：

dwCreationMode

一个标志值，该值指定打开颜色配置文件（如果它包含在文件中）时要执行的操作。 此参数必须采用以下值之一，这些值在 winbase.h 中定义：

dwFlags

一个标志值，该值指定是否使用嵌入的 WCS 配置文件。 除非 pCDMProfile 指定包含嵌入式 WCS 配置文件的 ICC 配置文件，否则此参数不起作用。

此参数采用以下值之一：

返回值

如果此函数成功，则返回值是打开的颜色配置文件的句柄。

如果此函数失败，则返回值为 NULL。

注解

此 API 将采用一组 DMP、CAMP 和 GMMP 并返回 WCS 配置文件句柄。 GMMP 的 NULL 值有效。 CAMP 的 NULL 值将替换为默认 CAMP 值。

此 API 还将接受 ICC 配置文件。 使用 ICC 配置文件并不能保证由 WCS CITE 引擎进行处理。 仅当至少传递一个 WCS 配置文件时，才会使用 WCS 引擎。 纯 ICC 工作流将与旧行为保持一致。

可以使用此函数在其他颜色配置文件管理功能中返回的句柄。

dwCreationMode 标志CREATE_NEW、CREATE_ALWAYS和TRUNCATE_EXISTING将始终返回空白 ICC HPROFIL。 如果存在其他 dwCreationMode 标志，则函数将确定配置文件是 ICC 还是 WCS XML。

在 ICC 代码路径中，使用上表中指定的请求共享、访问和创建标志返回 ICC HPROFILE。

在 WCS 路径中，如果配置文件不存在， dwCreationMode 标志OPEN_ALWAYS将失败，因为无法在 WCS 体系结构中创建或编辑 WCS 配置文件， (必须使用 MSXML6) 对其进行编辑。 出于同样的原因， dwShareMode 标志 FILE_SHARE_WRITE，dwDesiredAccess 标志PROFILE_READWRITE在 WCS 路径中被忽略。

创建颜色配置文件的句柄后，可以删除用于创建该句柄的任何信息。

使用 CloseColorProfile 函数关闭 由 WcsOpenColorProfile 返回的对象句柄。

要求

另请参阅

• 基本颜色管理概念
• Windows 颜色系统架构和算法
• 函数