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


Функция DrvIcmCheckBitmapBits (winddi.h)

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

Синтаксис

BOOL DrvIcmCheckBitmapBits(
  DHPDEV  dhpdev,
  HANDLE  hColorTransform,
  SURFOBJ *pso,
  PBYTE   paResults
);

Параметры

dhpdev

Дескриптор PDEV физического устройства.

hColorTransform

Дескриптор преобразования цвета, на соответствие которому будет проверяться растровое изображение. Это преобразование было создано драйвером с помощью предварительного вызова его подпрограммы DrvIcmCreateColorTransform .

pso

Указатель на SURFOBJ , содержащий проверяемую поверхность растрового изображения.

paResults

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

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

DrvIcmCheckBitmapBits возвращает значение TRUE при успешном выполнении. В противном случае он сообщает об ошибке и возвращает значение FALSE.

Комментарии

Каждый байт в массиве, на который указывает paResults , соответствует пикселю на растровом рисунке. Для каждого пикселя драйвер определяет, находится ли его значение цвета в гамме устройства, а затем записывает значение от нуля до 255 в соответствующем байте массива. Значения имеют следующие значения:

Значение Значение
Ноль Цвет находится в гамме устройства.
Ненулевой Цвет за пределами гаммы. Значение n+1 указывает, что цвет находится по крайней мере на той же гамме, что и значение n.
 

DrvIcmCheckBitmapBits можно реализовать в драйверах, поддерживающих ICM. Драйвер указывает на поддержку ICM, устанавливая флаг GCAPS_ICM в элементе flGraphicsCaps структуры DEVINFO .

Требования

Требование Значение
Целевая платформа Персональный компьютер
Верхняя часть winddi.h (включая Winddi.h)

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

DrvIcmCreateColorTransform