Функция 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) |