DrvQueryJobAttributes, fonction (winddiui.h)

Article
02/27/2024

La fonction DrvQueryJobAttributes permet à une DLL d’interface d’imprimante de spécifier la prise en charge de fonctionnalités telles que l’impression de plusieurs pages de documents sur une page physique (« N-up »), l’impression de plusieurs copies de chaque page, le regroupement des 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

Poignée d’imprimante fournie 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 vers lequel lpAttributeInfo pointe, comme indiqué dans le tableau suivant.

valeur dwLevel	ColumStructure pointé 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 retournée

Si l’opération réussit, la fonction doit retourner TRUE. Dans le cas contraire, elle doit retourner FALSE. Le retour de FALSE entraîne l’annulation du travail d’impression en cours.

Remarques

Une DLL d’interface d’imprimante peut éventuellement fournir une fonction DrvQueryJobAttributes . Si la fonction est fournie, elle doit remplir 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 étant généralement appelée par le processeur d’impression EMF, elle peut déterminer quels attributs de travail peuvent être gérés par le pilote (ou l’imprimante) et lesquels doivent être gérés par le processeur d’impression.