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


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

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

pcbProfileName

Указатель на расположение, которое получает размер (в байтах) имени пути цветового профиля по умолчанию, включая признак конца NULL .

Возвращаемое значение

Если эта функция завершается успешно, возвращается значение TRUE.

Если эта функция завершается сбоем, возвращается значение FALSE. Для получения дополнительных сведений об ошибке вызовите Метод GetLastError.

Комментарии

Эта функция используется для возврата требуемого размера буфера, на который указывает параметр pProfileName в функции WcsGetDefaultColorProfile .

Эта функция является исполняемой в контексте Least-Privileged учетной записи пользователя (LUA).

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Верхняя часть icm.h
Библиотека Mscms.lib
DLL Mscms.dll

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