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

Функция CMCheckColorsInGamut (icm.h)

  • Статья

[CMCheckColorsInGamut больше недоступен для использования с Windows Vista.]

Определяет, находятся ли указанные триплы RGB в выходной гамме указанного преобразования.

Синтаксис

BOOL CMCheckColorsInGamut(
  HCMTRANSFORM hcmTransform,
  RGBTRIPLE    *lpaRGBTriple,
  LPBYTE       lpaResult,
  UINT         nCount
);

Параметры

hcmTransform

Указывает используемое преобразование.

lpaRGBTriple

Указывает на массив rgb-троих для проверка.

lpaResult

Указывает на буфер, в который помещают результаты.

Результаты представлены массивом байтов. Каждый байт в массиве соответствует rgb triple и имеет неподписанное значение от 0 до 255. Значение 0 означает, что цвет находится в гамме, а ненулевое значение указывает на то, что цвет выходит за пределы гаммы. Для любого целого числа n в диапазоне 0 <n< 255 результирующий результат n + 1 указывает на то, что соответствующий цвет по крайней мере выходит за пределы гаммы, как было бы указано результирующим значением n.

nCount

Определяет количество элементов в массиве.

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

Начиная с Windows Vista, CMM по умолчанию (Icm32.dll) возвращает значение FALSE , а GetLastError — ERROR_NOT_SUPPORTED.

Windows Server 2003, Windows XP и Windows 2000:

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

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

Комментарии

Начиная с Windows Vista, реализующие CMM больше не требуются для реализации этого метода.

Windows Server 2003, Windows XP и Windows 2000:

Для реализации этого метода требуются реализующие CMM.

Для экспорта этой функции требуется каждый CMM.

Если функция не выполнена успешно, пользовательские CMM должны вызвать SetLastError , чтобы задать для последней ошибки допустимое значение ошибки, определенное в Winerror.h.

Требования

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

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