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

Статья
08/27/2023

Функция DrvSendPage библиотеки принтера вызывается GDI после завершения рисования физической страницы, поэтому драйвер может отправить страницу на принтер.

Синтаксис

BOOL DrvSendPage(
  [in] SURFOBJ *pso
);

Параметры

[in] pso

Поставляемый вызывающим элементом указатель на структуру SURFOBJ , описывающую поверхность рисования.

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

Если операция выполнена успешно, функция должна вернуть значение TRUE. В противном случае он должен вызвать функцию Win32 SetLastError , чтобы задать код ошибки, а затем вернуть значение FALSE.

GDI вызывает DrvSendPage каждый раз, когда завершает рисование изображения физической страницы на поверхности рисования. Функция отвечает за вызов EngWritePrinter для отправки изображения на принтер, а также за выполнение конечных операций, таких как извлечение страницы.

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

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

Если эта функция может занять много времени, она должна вызывать EngCheckAbort каждые пять секунд. Если EngCheckAbort возвращает значение TRUE, DrvSendPage должен завершить свою операцию и вернуть значение FALSE.