DrvQueryJobAttributes, fonction (winddiui.h)

Article
02/07/2025

La fonction DrvQueryJobAttributes permet à une DLL d’interface d’imprimante de spécifier la prise en charge des fonctionnalités telles que l’impression de plusieurs pages de documents sur une page physique (« impression N-up »), l’impression de plusieurs copies de chaque page, la collation de pages et l’impression de pages dans l’ordre inverse.

Syntaxe

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

Paramètres

[in] hPrinter

Handle d’imprimante fourni par l’appelant.

[in] pDevMode

Pointeur fourni par l’appelant vers une structure DEVMODEW.

[in] dwLevel

Valeur fournie par l’appelant indiquant le type de structure pointé par lpAttributeInfo, comme indiqué dans le tableau suivant.

valeur de dwLevel	ColumStructure pointée par lpAttributeInfo
1	ATTRIBUTE_INFO_1
2	ATTRIBUTE_INFO_2
3	ATTRIBUTE_INFO_3
4	ATTRIBUTE_INFO_4

[out] lpAttributeInfo

Pointeur fourni par l’appelant vers une structure identifiée par dwLevel .

Valeur de retour

Si l’opération réussit, la fonction doit retourner TRUE. Sinon, elle doit retourner FALSE. Le retour FAUX entraîne l’annulation du travail d’impression actuel.

Remarques

Une DLL d’interface d’imprimante peut éventuellement fournir une fonction DrvQueryJobAttributes. Si la fonction est fournie, elle doit renseigner la structure fournie, décrite par dwLevel et plAttributeInfo, pour indiquer les attributs demandés par l’utilisateur du travail d’impression actuel (tels que les paramètres N-up et le nombre de copies) et la capacité du pilote à prendre en charge ces attributs. La fonction est généralement appelée par le processeur d’impression EMF. Elle peut donc déterminer quels attributs de travail peuvent être gérés par le pilote (ou l’imprimante) et qui doivent être gérés par le processeur d’impression.