Méthode IPrintOemUI2 ::QueryJobAttributes (prcomoem.h)

Article
02/29/2024

La IPrintOemUI2::QueryJobAttributes méthode permet à un plug-in d’interface utilisateur de post-traiter les résultats du pilote principal après un appel à DDI DrvQueryJobAttributes . Le plug-in peut choisir de remplacer les valeurs que le pilote principal a placées dans la mémoire tampon de sortie lpAttributeInfo .

Syntaxe

HRESULT QueryJobAttributes(
  HANDLE   hPrinter,
  PDEVMODE pDevmode,
  DWORD    dwLevel,
  LPBYTE   lpAttributeInfo
);

Paramètres

hPrinter

Spécifie le handle d’imprimante fourni par l’appelant.

pDevmode

Pointeur vers une structure DEVMODEW fournie par l’appelant.

dwLevel

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

Valeur	Structure pointée par lpAttributeInfo
1	ATTRIBUTE_INFO_1
2	ATTRIBUTE_INFO_2
3	ATTRIBUTE_INFO_3
4	ATTRIBUTE_INFO_4

Notez que si cette méthode modifie un membre dwDrvXxx des structures ATTRIBUTE_INFO_N , le spouleur suppose que le plug-in est en mesure de prendre en charge le comportement représenté par ce membre.

lpAttributeInfo

Pointeur vers un emplacement de mémoire qui reçoit l’adresse d’une structure du type identifié par dwLevel.

Valeur retournée

Si le plug-in d’interface utilisateur prend en charge cette méthode et que la méthode a réussi, il doit retourner S_OK. Le pilote principal retourne alors TRUE pour DDI DrvQueryJobAttributes . Si le plug-in d’interface utilisateur prend en charge cette méthode, mais que la méthode a échoué, il doit retourner E_FAIL. Le pilote principal retourne alors false pour DDI DrvQueryJobAttributes. Si le plug-in d’interface utilisateur ne prend pas en charge cette méthode, il doit retourner E_NOTIMPL.

Remarques

Lorsque plusieurs plug-ins d’interface utilisateur sont installés sur l’imprimante, le pilote principal appelle les plug-ins d’interface utilisateur dans l’ordre dans lequel ils ont été installés. Le HRESULT retourné par le dernier plug-in d’interface utilisateur qui prend en charge cette méthode est utilisé pour déterminer la valeur de retour DDI DrvQueryJobAttributes du pilote principal, comme décrit dans la section précédente.

Pour plus d’informations, consultez DrvQueryJobAttributes .