drvQueryPerBandInfo 函数 (winddi.h)

打印机图形 DLL 的 DrvQueryPerBandInfo 函数在开始为物理页面绘制带之前由 GDI 调用,因此驱动程序可以为 GDI 提供特定于波段的信息。

语法

ULONG DrvQueryPerBandInfo(
  [in]      SURFOBJ     *pso,
  [in, out] PERBANDINFO *pbi
);

参数

[in] pso

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

[in, out] pbi

调用方提供的指向 PERBANDINFO 结构的指针,其中包含函数可以覆盖的默认信息。

返回值

函数必须返回以下值之一:

返回代码 说明
大于零
GDI 将使用 PERBANDINFO 结构的内容。
Zero
GDI 将忽略 PERBANDINFO 结构的内容。
DDI_ERROR
GDI 不会绘制带。

注解

如果 打印机图形 DLL 使用 GDI 管理的表面,并且它支持表面镶边,则可以选择提供 DrvQueryPerBandInfo 函数。 GDI 在呈现每个波段之前调用 函数。

打印机图形 DLL 使用函数的 PERBANDINFO 结构来指示是否应重绘上一个波段,并指定应缩放带。 如果打印机图形 DLL 支持带带,但不提供 DrvQueryPerBandInfo 函数,GDI 将不会重复或缩放带。

仅在播放 EMF 文件时调用 DrvQueryPerBandInfo 函数。

要求

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

另请参阅

DrvNextBand

DrvStartBanding