Функция CheckBitmapBits

Функция CheckBitmapBits проверяет находятся ли пиксели в заданном точечном рисунке в пределах выводимой гаммы цвета (gamut) заданного преобразования.

Синтаксис

BOOL WINAPI CheckBitmapBits(
  HTRANSFORM hColorTransform,
  PVOID pSrcBits,
  BMFORMAT bmInput, 
  DWORD dwWidth,
  DWORD dwHeight, 
  DWORD dwStride, 
  PBYTE paResult,
  PBMCALLBACKFN pfnCallback, 
  LPARAM lpCallbackData
);

Параметры

hColorTransform

Дескриптор используемого преобразования цвета.

pSrcBits

Указатель на точечный рисунок, который проверяется на предмет выводимой гаммы цвета.

bmInput

Определяет формат точечного рисунка. Должен быть установлен в одном из значений перечислимого типа BMFORMAT.

dwWidth

Определяет число пикселей в строке развертки точечного рисунка.

dwHeight

Определяет число строк развертки точечного рисунка.

dwStride

Определяет число байтов от начала одной строки развертки до начала следующей. Если параметр установлен в нуль, предполагается, что строки развертки точечного рисунка, будут дополняться, чтобы выровняться по границе СЛОВА (DWORD).

paResult

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

pfnCallback

Указатель на функцию обратного вызова, вызываемую периодически функцией CheckBitmapBits, чтобы сообщить о ходе процесса и дать возможность вызываемому процессу отменить проверку точечного рисунка. (См. описание функции ICMProgressProcCallback).

lpCallbackData

Данные, возвращенные в функцию обратного вызова, например, чтобы идентифицировать проверку точечного рисунка, которая сообщает о ходе процесса.

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

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

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

Замечания

Если формат вводимых данных не совместим с преобразованием цвета, функция CheckBitmapBits завершается ошибкой.

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

Смотри также

Обзор Основные концепции управления цветом, Функции, используемые ICM, ICMProgressProcCallback, BMFORMAT

Размещение и совместимость CheckBitmapBits
К	Windows XP	Да
л	Windows 2000 Professional	Да
и	Windows NT Workstation	Нет
е	Windows Me	Да
н	Windows 98	Да
т	Windows 95	Нет

С	Windows Server 2003	Да
е	Windows 2000 Server	Да
р	Windows NT Server	Нет
в
е
р
Используемая библиотека		Mscms.lib
Используемая DLL		-
Заголовочный файл
- объявлено в		Icm.h
- включено в		-
Unicode		Нет
Замечания по платформе		Не имеется