DrvNextBand 函数 (winddi.h)

项目
08/27/2023

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 将图像发送到打印机，并且它应在 pptl 指向的 POINTL 结构中返回下一个波段原点的索引。

绘制所有物理页面的带区后，函数应将 pptl 指向的 POINTL 结构的两个成员设置为 -1。