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

Функция EnumICMProfilesA (wingdi.h)

  • Статья

Функция EnumICMProfiles перечисляет различные профили цвета выходных данных, поддерживаемые системой для заданного контекста устройства.

Синтаксис

int EnumICMProfilesA(
  HDC          hdc,
  ICMENUMPROCA proc,
  LPARAM       param
);

Параметры

hdc

Указывает контекст устройства.

proc

Указывает адрес экземпляра процедуры функции обратного вызова, определенной приложением. (См. EnumICMProfilesProcallback.)

param

Данные, предоставляемые приложением, передаваемым функции обратного вызова, вместе с сведениями о профиле цвета.

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

Эта функция возвращает ноль, если приложение прерывает перечисление. Возвращаемое значение -1, если нет профилей цветов для перечисления. В противном случае возвращаемое значение является последним значением, возвращаемым функцией обратного вызова.

Замечания

Функция EnumICMProfiles возвращает список профилей, связанных с контекстом устройства (DC), и параметры которого соответствуют параметрам контроллера домена. Контекст устройства может содержать профили устройств, которые не связаны с определенными аппаратными устройствами или профилями устройств, которые не соответствуют параметрам контроллера домена. Профиль sRGB является примером. Функция SetICMProfile используется для связывания этих типов профилей с контроллером домена. Функцию GetICMProfile можно использовать для получения профиля, который не перечисляется функцией EnumICMProfiles.

Windows 95/98/Me:EnumICMProfilesW поддерживается Microsoft Layer для Юникода. Для этого необходимо добавить в приложение определенные файлы, как описано в Microsoft Layer для Юникода в Windows 95/98/Me Systems.

Заметка

Заголовок wingdi.h определяет EnumICMProfiles как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование Ценность
минимальные поддерживаемые клиентские Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер Windows 2000 Server [только классические приложения]
целевая платформа Виндоус
заголовка wingdi.h
библиотеки Gdi32.lib
DLL Gdi32.dll

См. также