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

Статья
08/27/2023

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

Синтаксис

ENGAPI BOOL EngBitBlt(
       SURFOBJ  *psoTrg,
       SURFOBJ  *psoSrc,
       SURFOBJ  *psoMask,
       CLIPOBJ  *pco,
       XLATEOBJ *pxlo,
       RECTL    *prclTrg,
       POINTL   *pptlSrc,
       POINTL   *pptlMask,
       BRUSHOBJ *pbo,
       POINTL   *pptlBrush,
  [in] ROP4     rop4
);

Параметры

psoTrg

Указатель на структуру SURFOBJ , которая определяет поверхность, на которой выполняется рисование.

psoSrc

Если это требуется для rop4 , указатель на структуру SURFOBJ, которая определяет источник для операции передачи битового блока.

psoMask

Указатель на структуру SURFOBJ, которая определяет поверхность, используемую в качестве маски. Маска определяется как растровое изображение с 1 битом на пиксель. Как правило, маска ограничивает область, которая должна быть изменена в области назначения. Маскирование выбирается rop4 со значением 0xAACC. Область назначения не затрагивается, если маска равна нулю.

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

Если значение этого параметра равно NULL и маска требуется для rop4, то используется неявная маска в кисти. Если маска является обязательной, psoMask переопределяет неявную маску в кисти.

pco

Указатель на структуру CLIPOBJ . Подпрограммы службы CLIPOBJ_Xxx предоставляются для перечисления области клипа в виде набора прямоугольников. Это перечисление ограничивает область назначения, которая будет изменена. По возможности GDI упрощает обрезку; Например, эта функция никогда не вызывается с одним прямоугольником обрезки. GDI обрезает прямоугольник назначения перед вызовом этой функции, делая дополнительную обрезку ненужной.

pxlo

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

prclTrg

Указатель на структуру RECTL в системе координат поверхности назначения, которая определяет область для изменения. Прямоугольник определяется двумя точками; верхний левый и нижний правый. Нижний и правый края этого прямоугольника не являются частью передачи битового блока, то есть прямоугольник является монопольным в правом нижнем углу.

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

pptlSrc

Указатель на структуру POINTL , которая определяет левый верхний угол исходного прямоугольника, если источник существует. Если источника нет, драйвер должен игнорировать этот параметр.

pptlMask

Указатель на структуру POINTL, которая определяет, какой пиксель в маске соответствует верхнему левому углу прямоугольника назначения. Если в psoMask не указана маска, драйвер должен игнорировать этот параметр.

pbo

Указатель на структуру BRUSHOBJ , используемую для определения шаблона для передачи битовых блоков. Подпрограмма службы BRUSHOBJ_pvGetRbrush GDI извлекает реализацию кисти устройства. Драйвер может игнорировать этот параметр, если для параметра rop4 не требуется шаблон.

pptlBrush

Указатель на структуру POINTL , которая определяет источник кисти в области назначения. Верхний левый пиксель кисти выравнивается в этом месте, и кисть повторяется в соответствии с ее размерами. Игнорируйте этот параметр, если для параметра rop4 не требуется шаблон.

[in] rop4

Представляет растровую операцию, которая определяет, как маски, шаблона, исходного и целевого пикселей объединяются для записи выходного пикселя на целевую поверхность.

Это кватернарная растровая операция, которая является естественным продолжением обычной тернарной операции Rop3. Rop4 имеет 16 соответствующих битов, которые аналогичны 8 определяющим битам Rop3. (Другие избыточные биты Rop3 игнорируются.) Самый простой способ реализации Rop4 — рассмотреть 2 байта отдельно. Нижний байт указывает Rop3, который должен вычисляться, где маска имеет значение 1. Высокий байт указывает Rop3, который можно вычислить и применить, где маска имеет значение 0.

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

Возвращаемое значение равно TRUE , если функция выполнена успешно. В противном случае это значение false, а код ошибки записывается в журнал.

Если поверхность устройства упорядочена в виде растрового изображения в стандартном формате, драйвер может запросить, чтобы GDI выполнил передачу битового блока, вызвав EngBitBlt. Драйвер может сделать это, если у него есть специальное оборудование для быстрой обработки простых передач, но он не хочет обрабатывать вызовы со сложными передачами.

Дополнительные сведения о растровых операциях см. в документации по Microsoft Windows SDK.

Требования


Минимальная версия клиента	Доступно в Windows 2000 и более поздних версиях операционных систем Windows.
Целевая платформа	Универсальное
Верхняя часть	winddi.h (включая Winddi.h)
Библиотека	Win32k.lib
DLL	Win32k.sys