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

2024-03-04

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

Синтаксис

BOOL DrvNextBand(
  [in] SURFOBJ *pso,
  [in] POINTL  *pptl
);

Параметры

[in] pso

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

[in] pptl

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

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

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

Если библиотека DLL графики принтера использует поверхности, управляемые GDI, и если она поддерживает чередование поверхностей, она должна предоставлять функцию DrvNextBand . GDI вызывает DrvNextBand каждый раз, когда завершает рисование части изображения страницы, которая может содержаться на поверхности полосы. Поверхность, используемая GDI для рисования, — это поверхность, указанная драйвером ранее путем вызова EngMarkBandingSurface. Функция должна отправить изображение на принтер, вызвав EngWritePrinter, и она должна возвращать индексы источника следующего диапазона в структуре POINTL, на которую указывает pptl.

После рисования всех диапазонов физической страницы функция должна задать для обоих членов структуры POINTL, на которые указывает pptl , значение -1.