WcsGetDefaultColorProfileSize 函数 (icm.h)

  • 项目

返回设备的默认颜色配置文件名称的大小（以字节为单位）， (包括 NULL 终止符) 。

注意

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

语法

BOOL WcsGetDefaultColorProfileSize(
  WCS_PROFILE_MANAGEMENT_SCOPE scope,
  PCWSTR                       pDeviceName,
  COLORPROFILETYPE             cptColorProfileType,
  COLORPROFILESUBTYPE          cpstColorProfileSubType,
  DWORD                        dwProfileID,
  PDWORD                       pcbProfileName
);

参数

scope

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

pDeviceName

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

cptColorProfileType

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

cpstColorProfileSubType

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

dwProfileID

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

pcbProfileName

指向一个位置的指针，该位置接收默认颜色配置文件（包括 NULL 终止符）的路径名称的大小（以字节为单位）。

返回值

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

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

注解

使用此函数可返回 WcsGetDefaultColorProfile 函数中 pProfileName 参数指向的缓冲区的所需大小。

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

要求

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

另请参阅