WcsGetDefaultColorProfile 函数 (icm.h)

  • 项目

检索设备的默认颜色配置文件，如果未指定设备，则检索与设备无关的默认颜色配置文件。

注意

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

语法

BOOL WcsGetDefaultColorProfile(
  WCS_PROFILE_MANAGEMENT_SCOPE scope,
  PCWSTR                       pDeviceName,
  COLORPROFILETYPE             cptColorProfileType,
  COLORPROFILESUBTYPE          cpstColorProfileSubType,
  DWORD                        dwProfileID,
  DWORD                        cbProfileName,
  LPWSTR                       pProfileName
);

parameters

scope

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

pDeviceName

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

cptColorProfileType

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

cpstColorProfileSubType

指定颜色配置文件子 类型的 COLORPROFILESUBTYPE 值。

dwProfileID

颜色配置文件表示的颜色空间的 ID。

cbProfileName

pProfileName 指向的缓冲区的缓冲区大小（以字节为单位）。

pProfileName

指向用于接收颜色配置文件名称的缓冲区的指针。 缓冲区的大小（以字节为单位）将由 cbProfileName 指示。

返回值

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

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

注解

使用 WcsGetDefaultColorProfileSize 函数获取 pProfileName 参数指向的缓冲区的所需大小。

如果存在WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER，它将替代 profileManagementScope 的系统范围默认值。

此函数在 Least-Privileged 用户帐户 (LUA) 上下文中是可执行的。

要求

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

另请参阅