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

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

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

Синтаксис

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

Параметры

hcmTransform

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

lpaRGBTriple

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

lpaResult

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

Результаты представлены массивом байтов. Каждый байт в массиве соответствует тройной rgb и имеет неподписаемое значение от 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.

Требования

См. также

• Основные понятия управления цветами
• Функции