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) |