Функция CMCheckColors (icm.h)
Определяет, находятся ли заданные цвета в выходной гамме указанного преобразования.
Синтаксис
BOOL CMCheckColors(
HCMTRANSFORM hcmTransform,
LPCOLOR lpaInputColors,
DWORD nColors,
COLORTYPE ctInput,
LPBYTE lpaResult
);
Параметры
hcmTransform
Дескриптор преобразования цвета для использования.
lpaInputColors
Указатель на массив структур COLOR для проверка в выходной гамме.
nColors
Определяет количество элементов в массиве.
ctInput
Указывает тип цвета ввода.
lpaResult
Указатель на буфер, в который нужно поместить массив байтов, содержащий результаты теста. Каждый байт в буфере соответствует структуре COLOR , а при выходе задается значение без знака в диапазоне от 0 до 255. Значение 0 указывает, что цвет находится в гамме, а ненулевое значение указывает на то, что цвет выходит за пределы гаммы. Для любого целого числа n , такого как 0 <n< 255, результирующий значение n + 1 указывает на то, что соответствующий цвет по крайней мере настолько далеко от гаммы, что было бы указано результирующим значением n. Эти значения обычно создаются из gamutTag в профиле ICC.
Возвращаемое значение
Если эта функция завершается успешно, возвращается значение TRUE.
Если эта функция завершается сбоем, возвращается значение FALSE. Если функция не выполнена успешно, CMM должна вызвать SetLastError , чтобы задать для последней ошибки допустимое значение ошибки, определенное в Winerror.h.
Комментарии
Для экспорта этой функции требуется каждый CMM.
Если входной тип цвета несовместим с преобразованием цвета CMCheckColors, происходит сбой .
Требования
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Верхняя часть | icm.h |