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 |