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

Статья
03/04/2024

Функция DrvStartBanding вызывается GDI, когда она готова начать отправку полос физической страницы драйверу для отрисовки.

Синтаксис

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

Параметры

[in] pso

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

[in] pptl

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

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

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

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

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

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