drvStartBanding 函数 (winddi.h)

当 DrvStartBanding 函数准备好开始将物理页面的波段发送到驱动程序进行呈现时,GDI 将调用它。

语法

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

参数

[in] pso

调用方提供的指向用于标识条带图面的 SURFOBJ 结构的指针。

[in] pptl

调用方提供的指向 POINTL 结构的指针,用于接收第一个波段的函数提供的原点。

返回值

如果操作成功,函数应返回 TRUE。 否则,它应调用 Win32 SetLastError 函数来设置错误代码,然后返回 FALSE

注解

如果打印机图形 DLL 使用 GDI 管理的表面,并且它支持表面镶边,则必须提供 DrvNextBand 函数。 仅当打印机图形 DLL 的 DrvEnableSurface 函数以前调用 EngMarkBandingSurface 以指定条带表面时,GDI 才调用 DrvStartBanding

DrvStartBanding 函数的用途是允许打印机图形 DLL 在物理页面上开始镶边操作之前执行所需的任何初始化,并为 GDI 提供第一个波段原点的索引。

DrvStartBanding 函数每页调用一次。 每次 GDI 完成绘制带时,它都会调用 DrvNextBand ,以便驱动程序可以将带发送到打印机。

要求

要求
目标平台 桌面
标头 winddi.h (包括 Winddi.h)

另请参阅

DrvEnableSurface

DrvNextBand

EngMarkBandingSurface