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 |