drvNextBand 函数 (winddi.h)

GDI 调用 DrvNextBand 函数时,它已完成为物理页绘制带,因此驱动程序可以将下一个带状发送到打印机。

语法

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。

要求

   
目标平台 台式机
标头 winddi.h (包括 Winddi.h)

另请参阅

DrvEnableSurface

DrvStartBanding

EngMarkBandingSurface

EngWritePrinter