WcsSetDefaultColorProfile 函数 (icm.h)

  • 项目

为指定的配置文件管理范围中的指定配置文件类型设置默认颜色配置文件名称。

注意

此 API 不支持 HDR 监视器的“高级颜色”配置文件。 使用 ColorProfileSetDisplayDefaultAssociation 管理高级颜色配置文件。

语法

BOOL WcsSetDefaultColorProfile(
  WCS_PROFILE_MANAGEMENT_SCOPE scope,
  PCWSTR                       pDeviceName,
  COLORPROFILETYPE             cptColorProfileType,
  COLORPROFILESUBTYPE          cpstColorProfileSubType,
  DWORD                        dwProfileID,
  LPCWSTR                      pProfileName
);

parameters

scope

一个WCS_PROFILE_MANAGEMENT_SCOPE值，该值指定此配置文件管理操作的范围。

pDeviceName

指向要为其设置默认颜色配置文件的设备名称的指针。 如果 为 NULL，则使用与设备无关的默认配置文件。

cptColorProfileType

一个 COLORPROFILETYPE 值，该值指定颜色配置文件类型。

cpstColorProfileSubType

一个 COLORPROFILESUBTYPE 值，该值指定颜色配置文件子类型。

dwProfileID

颜色配置文件表示的颜色空间的 ID。 这是一个自定义 ID 值，用于唯一标识应用程序中的颜色空间配置文件。

pProfileName

指向保存颜色配置文件名称的缓冲区的指针。 请参阅“备注”。

返回值

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

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

注解

如果 pProfileName 参数为 NULL 且 profileManagementScope 参数WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER，则后续调用 WcsSetDefaultColorProfile 将返回系统范围的默认配置文件。

如果 profileManagementScope WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER，则此函数在 LUA) 上下文 Least-Privileged 用户帐户 (可执行。 否则，需要管理权限。 指定的配置文件必须已安装，但它可能尚未与指定配置文件管理范围内的指定设备相关联。

如果 profileManagementScope WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER，则如果从系统上下文而不是用户帐户启动，则此函数将无法正常运行。

调用 WcsSetDefaultColorProfile 将设备型号配置文件 DMP 设置为 RGB 或自定义工作区的默认配置文件时，只有类型为 RGBVirtualDevice、LCD 或 CRT 的 DMP 配置文件有效;所有其他项均无效。

调用 WcsSetDefaultColorProfile 将国际颜色联盟 (ICC) 配置文件设置为 RGB 或自定义工作空间的默认配置文件时，只有具有类“spac”或“disp”且“RGB”颜色空间的 ICC 配置文件有效;所有其他项均无效。

请参阅有关有效配置文件类型/子类型组合的说明。

要求

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

另请参阅