DrvQueryJobAttributes function (winddiui.h)
The DrvQueryJobAttributes function allows a printer interface DLL to specify support for such capabilities as printing multiple document pages on a physical page ("N-up" printing), printing multiple copies of each page, collating pages, and printing pages in reverse order.
Syntax
BOOL DrvQueryJobAttributes(
[in] HANDLE hPrinter,
[in] PDEVMODE pDevMode,
[in] DWORD dwLevel,
[out] LPBYTE lpAttributeInfo
);
Parameters
[in] hPrinter
Caller-supplied printer handle.
[in] pDevMode
Caller-supplied pointer to a DEVMODEW structure.
[in] dwLevel
Caller-supplied value indicating the type of structure pointed to by lpAttributeInfo, as indicated in the following table.
| dwLevel value | ColumStructure pointed to by lpAttributeInfo |
|---|---|
| 1 | ATTRIBUTE_INFO_1 |
| 2 | ATTRIBUTE_INFO_2 |
| 3 | ATTRIBUTE_INFO_3 |
| 4 | ATTRIBUTE_INFO_4 |
[out] lpAttributeInfo
Caller-supplied pointer to a structure identified by dwLevel.
Return value
If the operation succeeds, the function should return TRUE. Otherwise, it should return FALSE. Returning FALSE causes the current print job to be canceled.
Remarks
A printer interface DLL can optionally provide a DrvQueryJobAttributes function. If the function is provided, it should fill in the supplied structure, described by dwLevel and plAttributeInfo, to indicate the current print job's user-requested attributes (such as N-up parameters and the number of copies) and the driver's ability to support those attributes. The function is typically called by the EMF print processor, so it can determine which job attributes can be handled by the driver (or printer), and which must be handled by the print processor.
Requirements
| Requirement | Value |
|---|---|
| Target Platform | Desktop |
| Header | winddiui.h (include Winddiui.h) |