ATTRIBUTE_INFO_4 structure

The ATTRIBUTE_INFO_4 structure is used as a parameter for a printer interface DLL's DrvQueryJobAttributes function. All member values are function-supplied. This structure is similar to ATTRIBUTE_INFO_3, but it includes additional members to control N-up, duplex and booklet printing, and scaling.

Syntax


typedef struct _ATTRIBUTE_INFO_4 {
  DWORD dwJobNumberOfPagesPerSide;
  DWORD dwDrvNumberOfPagesPerSide;
  DWORD dwNupBorderFlags;
  DWORD dwJobPageOrderFlags;
  DWORD dwDrvPageOrderFlags;
  DWORD dwJobNumberOfCopies;
  DWORD dwDrvNumberOfCopies;
  DWORD dwColorOptimization;
  short dmPrintQuality;
  short dmYResolution;
  DWORD dwDuplexFlags;
  DWORD dwNupDirection;
  DWORD dwBookletFlags;
  DWORD dwScalingPercentX;
  DWORD dwScalingPercentY;
} ATTRIBUTE_INFO_4, *PATTRIBUTE_INFO_4;

Members

dwJobNumberOfPagesPerSide

Number of document pages to be placed on one side of a physical page, as requested by the user. Allowable values are 1, 2, 4, 6, 9, or 16.

dwDrvNumberOfPagesPerSide

Number of document pages that the printer and driver can place on one side of a physical page. This value must be 1 or the value specified for dwJobNumberOfPagesPerSide.

dwNupBorderFlags

One of the following bit flag values:

FlagDefinition

BORDER_PRINT

The print processor should draw a border around the page.

NO_BORDER_PRINT

The print processor should not draw a border around the page.

 

dwJobPageOrderFlags

One of the following bit flag values:

FlagDefinition

BOOKLET_PRINT

Pages should be printed in booklet form, with two document pages printed on one side of a physical page. In landscape mode, the two document pages are printed side-by-side on the paper. In portrait mode, the two document pages are printed top-and-bottom.

NORMAL_PRINT

Pages should be printed in normal order: page 1, page 2, and so on.

REVERSE_PRINT

Pages should be printed in reverse order: last page, next-to-last page, and so on.

 

dwDrvPageOrderFlags

Bit flags indicating which page ordering options are supported by the printer and driver. Uses the same flags as dwJobPageOrderFlags.

dwJobNumberOfCopies

Number of copies of the print job, as requested by the user.

dwDrvNumberOfCopies

Maximum number of copies the printer and driver can handle at once, taking into account such job attributes as collating and stapling.

dwColorOptimization

One of the following bit flag values:

FlagDefinition

COLOR_OPTIMIZATION

The print processor should use monochrome color optimization.

NO_COLOR_OPTIMIZATION

The print processor should not use monochrome color optimization.

 

dmPrintQuality

Value to be used instead of the dmPrintQuality member of the print job's DEVMODEW structure, if the COLOR_OPTIMIZATION flag is set in dwColorOptimization.

dmYResolution

Value to be used instead of the dmYResolution member of the print job's DEVMODEW structure, if the COLOR_OPTIMIZATION flag is set in dwColorOptimization.

dwDuplexFlags

One of the following bit flag values used in duplex printing:

FlagDefinition

DONT_SEND_EXTRA_PAGES_FOR_DUPLEX

The print processor should not send extra blank pages when duplex printing.

For example, if you send a three-page job for duplex printing, some printers expect to receive four pages. If you print this job on Microsoft Windows XP or Windows Server 2003, the print processor sends four pages to the printer by default (the fourth page is a blank page). If you print this job on Windows Vista with this flag set, the print processor sends only the three pages of the print job and does not send the extra blank page.

REVERSE_PAGES_FOR_REVERSE_DUPLEX

The print processor should reverse the order of page pairs when printing in reverse duplex mode. For example, when this flag is set, the print processor should print pages in order 7, 8, 5, 6, 3, 4, 1, 2 instead of 8, 7, 6, 5, 4, 3, 2, 1.

 

Set to 0 if your driver does not require any of these options.

dwNupDirection

One of the following bit flag values used in N-up printing:

FlagDefinition

RIGHT_THEN_DOWN

The print processor should provide page images in sequence from left to right, then down the final printed page. Also set to this value if N-up printing is not needed.

DOWN_THEN_RIGHT

The print processor should provide page images in sequence from top to bottom, then left to right on the final printed page.

LEFT_THEN_DOWN

The print processor should provide page images in sequence from right to left, then down the final printed page.

DOWN_THEN_LEFT

The print processor should provide page images in sequence from top to bottom, then right to left on the final printed page.

 

This flag is considered only if dwJobNumberOfPagesPerSide and/or dwDrvNumberOfPagesPerSide indicate that N-up printing is active. For more information, see the descriptions above for dwJobNumberOfPagesPerSide and dwDrvNumberOfPagesPerSide.

dwBookletFlags

If dwJobPageOrderFlags is set to BOOKLET_PRINT, one of the following values.

FlagDefinition

BOOKLET_EDGE_LEFT

The print processor should print pages in a left-to-right booklet layout, where the bound edge of the final folded booklet is on the left edge of page one.

BOOKLET_EDGE_RIGHT

The print processor should print pages in a right-to-left booklet layout, where the bound edge of the final folded booklet is on the right edge of page one.

 

If dwJobPageOrderFlags is not set to BOOKLET_PRINT, dwBookletFlags is set to 0.

This flag is considered only if the dwJobPageOrderFlags member is set to BOOKLET_PRINT.

dwScalingPercentX

Scaling percentage in the horizontal (x) direction with respect to the normal paper size. Must be in the range of 1 to 1000. Set to 100 if scaling will not be done.

Note   To ensure predictable printing results, dwScalingPercentX and dwScalingPercentY must have the same value.

dwScalingPercentY

Scaling percentage in the vertical (y) direction with respect to the normal paper size. Must be in the range of 1 to 1000. Set to 100 if scaling will not be done.

Note   To ensure predictable printing results, dwScalingPercentX and dwScalingPercentY must have the same value.

Remarks

If the dmPrintQuality member of a print job's DEVMODEW structure is a negative value, such as DMRES_HIGH, and if monochrome color optimization is enabled, then switching between color and monochrome could result in different resolutions being used. This is because DMRES_HIGH might be assigned to different DPI values for color and monochrome rendering. (For Unidrv-supported devices, this assignment occurs in the printer's GPD file.) To ensure a consistent resolution throughout the print job, the driver can specify positive dmPrintQuality and dmYResolution values (representing a specific DPI resolution) to override the equivalent DEVMODEW values.

The EMF print processor uses the flag specified for dwColorOptimization to determine whether to request GDI to perform monochrome color optimization. If monochrome color optimization is enabled, the print job can be switched between monochrome and color rendering as appropriate.

If you are creating a Unidrv rendering plug-in to generate color watermarks, note that when the dwColorOptimization member is set to COLOR_OPTIMIZATION, color watermarks are printed in black and white when they are printed on black-and-white documents. To ensure that color watermarks print correctly with color and black-and-white documents, disable color optimization. Color optimization also can be controlled by the Unidrv *ChangeColorModeOnDoc? color attribute (see Color Attributes), and by the GdiEndPageEMF function.

For a list of default values for ATTRIBUTE_INFO_4 members, see GetJobAttributesEx.

This structure is available in Windows Vista.

Requirements

Header

Winddiui.h (include Winddiui.h)

See also

ATTRIBUTE_INFO_2
ATTRIBUTE_INFO_3
DrvQueryJobAttributes
GetJobAttributesEx
GdiEndPageEMF

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft