Поделиться через

Функция 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

См. также раздел