ATTRIBUTE_INFO_3结构（winddiui.h）

项目
02/07/2025

ATTRIBUTE_INFO_3结构用作打印机接口 DLL DrvQueryJobAttributes 函数的参数。所有成员值都是函数提供的。

语法

typedef struct _ATTRIBUTE_INFO_3 {
  DWORD dwJobNumberOfPagesPerSide;
  DWORD dwDrvNumberOfPagesPerSide;
  DWORD dwNupBorderFlags;
  DWORD dwJobPageOrderFlags;
  DWORD dwDrvPageOrderFlags;
  DWORD dwJobNumberOfCopies;
  DWORD dwDrvNumberOfCopies;
  DWORD dwColorOptimization;
  short dmPrintQuality;
  short dmYResolution;
} ATTRIBUTE_INFO_3, *PATTRIBUTE_INFO_3;

成员

dwJobNumberOfPagesPerSide

用户请求，要放置在物理页面的一侧的文档页数。允许的值为 1、2、4、6、9 或 16。

dwDrvNumberOfPagesPerSide

打印机和驱动程序可以在物理页面的一侧放置的文档页数。此值必须为 1 或为 dwJobNumberOfPagesPerSide指定的值。

dwNupBorderFlags

以下位标志值之一：

旗	定义
BORDER_PRINT	打印处理器应绘制页面周围的边框。
NO_BORDER_PRINT	打印处理器不应在页面周围绘制边框。

dwJobPageOrderFlags

以下位标志值之一：

旗	定义
BOOKLET_PRINT	页面应以小册子形式打印，其中两个文档页打印在物理页面的一侧。在横向模式下，两个文档页在纸张上并排打印。在纵向模式下，打印两个文档页的顶部和底部。
NORMAL_PRINT	页面应按正常顺序打印：第 1 页、第 2 页等。
REVERSE_PRINT	页面应按相反顺序打印：最后一页、最后一页等。

dwDrvPageOrderFlags

指示打印机和驱动程序支持哪些页面排序选项的位标志。使用与 dwJobPageOrderFlags相同的标志。

dwJobNumberOfCopies

用户请求的打印作业副本数。

dwDrvNumberOfCopies

打印机和驱动程序可以同时处理的最大副本数，并考虑到排序和装订等作业属性。

dwColorOptimization

以下位标志值之一：

旗	定义
COLOR_OPTIMIZATION	打印处理器应使用单色颜色优化。
NO_COLOR_OPTIMIZATION	打印处理器不应使用单色颜色优化。

dmPrintQuality

要在 dwColorOptimization中设置COLOR_OPTIMIZATION标志，而不是打印作业 DEVMODEW 结构的 dmPrintQuality 成员的值。

dmYResolution

如果要使用的值，而不是打印作业 DEVMODEW 结构的 dmYResolution 成员，如果在 dwColorOptimization 中设置COLOR_OPTIMIZATION标志。

言论

如果打印作业 DEVMODEW 结构的 dmPrintQuality 成员是负值（如 DMRES_HIGH），并且启用了单色颜色优化，则在颜色和单色之间切换可能会导致使用不同的分辨率。这是因为DMRES_HIGH可能分配给颜色和单色呈现的不同 DPI 值。（对于 Unidrv 支持的设备，此分配发生在打印机的 GPD 文件中。为了确保整个打印作业的分辨率一致，驱动程序可以指定正 dmPrintQuality，dmYResolution 值（表示特定的 DPI 分辨率），以替代等效 的 DEVMODEW 值。

EMF 打印处理器使用为 dwColorOptimization 指定的标志 来确定是否请求 GDI 执行单色颜色优化。如果启用了单色颜色优化，则可以根据需要在单色和颜色呈现之间切换打印作业。

如果要创建 Unidrv 呈现插件以生成颜色水印，请注意，当 dwColorOptimization 成员设置为COLOR_OPTIMIZATION时，在黑白文档中打印颜色水印时，颜色水印将印在黑白文档中。若要确保使用颜色和黑白文档正确打印颜色水印，请禁用颜色优化。颜色优化还可以由 Unidrv *ChangeColorModeOnDoc 控制？ 颜色属性（请参阅颜色属性），以及 GdiEndPageEMF 函数。

有关其他ATTRIBUTE_INFO_3结构成员的信息，请参阅 ATTRIBUTE_INFO_1 和 ATTRIBUTE_INFO_2。