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