DrvQueryJobAttributes 函数 (winddiui.h)

项目
03/05/2024

DrvQueryJobAttributes 函数允许打印机接口 DLL 指定对以下功能的支持：在物理页上打印多个文档页 (“N-up”打印) 、打印每个页面的多个副本、整理页面以及按相反顺序打印页面。

语法

BOOL DrvQueryJobAttributes(
  [in]  HANDLE   hPrinter,
  [in]  PDEVMODE pDevMode,
  [in]  DWORD    dwLevel,
  [out] LPBYTE   lpAttributeInfo
);

参数

[in] hPrinter

调用方提供的打印机句柄。

[in] pDevMode

调用方提供的指向 DEVMODEW 结构的指针。

[in] dwLevel

调用方提供的值，指示 lpAttributeInfo 指向的结构类型，如下表所示。

dwLevel 值	lpAttributeInfo 指向的 ColumStructure
1	ATTRIBUTE_INFO_1
2	ATTRIBUTE_INFO_2
3	ATTRIBUTE_INFO_3
4	ATTRIBUTE_INFO_4

[out] lpAttributeInfo

调用方提供的指向 由 dwLevel 标识的结构的指针。

返回值

如果操作成功，函数应返回 TRUE。否则，它应返回 FALSE。返回 FALSE 会导致取消当前打印作业。

注解

打印机接口 DLL 可以选择提供 DrvQueryJobAttributes 函数。如果提供了函数，则它应填充提供的结构（由 dwLevel 和 plAttributeInfo 描述），以指示当前打印作业的用户请求属性 (，例如 N-up 参数和) 副本数以及驱动程序支持这些属性的能力。函数通常由 EMF 打印处理器调用，因此它可以确定哪些作业属性可由驱动程序 (或打印机) 处理，哪些作业属性必须由打印处理器处理。