Funzione DrvQueryJobAttributes (winddiui.h)

Articolo
08/08/2023

La funzione DrvQueryJobAttributes consente a una DLL dell'interfaccia della stampante di specificare il supporto per tali funzionalità, ad esempio la stampa di più pagine di documenti in una pagina fisica ("N-up"), la stampa di più copie di ogni pagina, la compressione di pagine e la stampa di pagine in ordine inverso.

Sintassi

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

Parametri

[in] hPrinter

Handle stampante fornito dal chiamante.

[in] pDevMode

Puntatore fornito dal chiamante a una struttura DEVMODEW .

[in] dwLevel

Valore fornito dal chiamante che indica il tipo di struttura a cui punta lpAttributeInfo, come indicato nella tabella seguente.

valore dwLevel	ColumStructure a cui punta lpAttributeInfo
1	ATTRIBUTE_INFO_1
2	ATTRIBUTE_INFO_2
3	ATTRIBUTE_INFO_3
4	ATTRIBUTE_INFO_4

[out] lpAttributeInfo

Puntatore fornito dal chiamante a una struttura identificata da dwLevel.

Valore restituito

Se l'operazione ha esito positivo, la funzione deve restituire TRUE. In caso contrario, deve restituire FALSE. Se si restituisce FALSE , il processo di stampa corrente viene annullato.

Commenti

Una DLL dell'interfaccia della stampante può facoltativamente fornire una funzione DrvQueryJobAttributes . Se la funzione viene fornita, deve compilare la struttura fornita, descritta da dwLevel e plAttributeInfo, per indicare gli attributi richiesti dall'utente del processo di stampa corrente (ad esempio i parametri N-up e il numero di copie) e la capacità del driver di supportare tali attributi. La funzione viene in genere chiamata dal processore di stampa EMF, in modo che possa determinare quali attributi del processo possono essere gestiti dal driver (o dalla stampante) e che devono essere gestiti dal processore di stampa.