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

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

Параметры

scope

Значение WCS_PROFILE_MANAGEMENT_SCOPE, указывающее область этой операции управления профилями.

pDeviceName

Указатель на имя устройства, для которого получен цветной профиль по умолчанию. При значении NULL получается профиль по умолчанию, независимый от устройства.

cptColorProfileType

Значение COLORPROFILETYPE , указывающее тип цветового профиля.

cpstColorProfileSubType

Значение COLORPROFILESUBTYPE , указывающее подтип профиля цвета.

dwProfileID

Идентификатор цветового пространства, представляемого цветовым профилем.

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
Библиотека Mscms.lib
DLL Mscms.dll

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