Функция WcsSetDefaultColorProfile (icm.h)
Задает имя цветового профиля по умолчанию для указанного типа профиля в указанном область управления профилями.
Примечание
Этот API не поддерживает "расширенные цветовые" профили для мониторов HDR. Используйте ColorProfileSetDisplayDefaultAssociation для управления расширенными цветными профилями.
Синтаксис
BOOL WcsSetDefaultColorProfile(
WCS_PROFILE_MANAGEMENT_SCOPE scope,
PCWSTR pDeviceName,
COLORPROFILETYPE cptColorProfileType,
COLORPROFILESUBTYPE cpstColorProfileSubType,
DWORD dwProfileID,
LPCWSTR pProfileName
);
Параметры
scope
Значение WCS_PROFILE_MANAGEMENT_SCOPE, указывающее область этой операции управления профилем.
pDeviceName
Указатель на имя устройства, для которого должен быть задан цветовой профиль по умолчанию. Если значение РАВНО NULL, используется профиль по умолчанию, независимый от устройства.
cptColorProfileType
Значение COLORPROFILETYPE , указывающее тип цветового профиля.
cpstColorProfileSubType
Значение COLORPROFILESUBTYPE , указывающее подтип цветового профиля.
dwProfileID
Идентификатор цветового пространства, представленного цветовым профилем. Это пользовательское значение идентификатора, используемое для уникальной идентификации профиля цветового пространства в приложении.
pProfileName
Указатель на буфер, содержащий имя цветового профиля. См. заметки.
Возвращаемое значение
Если эта функция завершается успешно, возвращается значение TRUE.
Если эта функция завершается сбоем, возвращается значение FALSE. Для получения дополнительных сведений об ошибке вызовите Метод GetLastError.
Комментарии
Если параметр pProfileName имеет значение NULL , а параметр profileManagementScope — WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER, последующие вызовы WcsSetDefaultColorProfile будут возвращать системный профиль по умолчанию.
Если параметр profileManagementScope WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER, эта функция является исполняемой в контексте Least-Privileged учетной записи пользователя (LUA). В противном случае требуются права администратора. Указанный профиль уже должен быть установлен, но он может быть еще не связан с указанным устройством в указанном область управления профилями.
Если параметр profileManagementScope WCS_PROFILE_MANAGEMENT_SCOPE_CURRENT_USER, эта функция будет работать неправильно при запуске из системного контекста, а не из учетной записи пользователя.
При вызове WcsSetDefaultColorProfile для установки профиля модели устройства DMP в качестве профиля по умолчанию для RGB или пользовательского рабочего пространства допустим только профиль DMP типа RGBVirtualDevice, ЖК-дисплей или CRT; все остальные являются недопустимыми.
При вызове WcsSetDefaultColorProfile для задания профиля Международного консорциума цветов (ICC) в качестве профиля по умолчанию для RGB или пользовательского рабочего пространства допустим только профиль ICC с классом spac или disp и цветовым пространством RGB; все остальные являются недопустимыми.
См. примечания о допустимых сочетаниях типов и подтипов профилей.
Требования
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Верхняя часть | icm.h |
| Библиотека | Mscms.lib |
| DLL | Mscms.dll |