drvSendPage 函数 (winddi.h)

打印机图形 DLL 的 DrvSendPage 函数在绘制完物理页面后由 GDI 调用,因此驱动程序可以将页面发送到打印机。

语法

BOOL DrvSendPage(
  [in] SURFOBJ *pso
);

参数

[in] pso

调用方提供的指向描述绘图图面的 SURFOBJ 结构的指针。

返回值

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

注解

每次完成在绘图图面上绘制物理页面的图像时,GDI 都会调用 DrvSendPage 。 函数负责调用 EngWritePrinter 以将图像发送到打印机,并执行页面结束操作,例如弹出页面。

通常实现使用 GDI 托管图面的打印机图形 DLL,以便对于已镶边的页面,驱动程序的 DrvNextBand 函数将每个带的图像发送到打印机。

此外,如果打印机图形 DLL 使用 设备管理的表面则 DrvSendPage 函数通常只需执行页尾操作,因为图像在绘制时会发送到打印机。

如果此函数可能需要很长时间才能执行,则应每隔五秒调用 EngCheckAbort 。 如果 EngCheckAbort 返回 TRUE则 DrvSendPage 应终止其操作并返回 FALSE

要求

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

另请参阅

DrvNextBand

DrvStartPage

EngCheckAbort

EngWritePrinter