DevQueryPrintEx, fonction (winddiui.h)

Une dll d’interface d’imprimante DevQueryPrintEx, détermine si un travail d’impression spécifié est compatible avec la configuration actuelle de l’imprimante et peut donc être imprimé.

Syntaxe

BOOL DevQueryPrintEx(
  [in, out] PDEVQUERYPRINT_INFO pDQPInfo
);

Paramètres

[in, out] pDQPInfo

Pointeur fourni par l’appelant vers une structure DEVQUERYPRINT_INFO.

Valeur de retour

Si le travail d’impression peut être imprimé, la fonction doit retourner TRUE; sinon, elle doit retourner FAUX.

Remarques

Les DLL de l’interface d’imprimante doivent définir une fonction DevQueryPrintEx. La fonction est appelée par le spouleur d’impression si l’option Hold Mismatched Documents est cochée sur la page Advanced de la feuille de propriétés de l’imprimante. Si la fonction retourne TRUE, le spouleur met en file d’attente le travail d’impression pour l’impression. Sinon, le travail est conservé, sous l’hypothèse que l’imprimante sera finalement reconfigurée afin que le travail puisse imprimer.

La structure DEVQUERYPRINT_INFO reçue pointe vers une structure DEVMODEW décrivant les caractéristiques de l’imprimante requises par le travail d’impression. La fonction DevQueryPrintEx doit d’abord vérifier que la taille et les membres de version de la structure DEVMODEW reçue sont compatibles avec le pilote. Ensuite, il doit déterminer si le contenu DEVMODEW fourni est compatible avec la configuration actuelle de l’imprimante.

Si le travail peut être imprimé, la fonction doit simplement retourner TRUE. Si le travail doit être conservé jusqu’à une date ultérieure, la fonction doit retourner FALSE après avoir fourni une chaîne de texte affichable (dans la mémoire tampon pointée par DEVQUERYPRINT_INFO le pszErrorStr membre) décrivant la raison pour laquelle le travail ne peut pas être imprimé.

Les chaînes de texte affichables doivent être définies en tant que ressources de chaîne dans un fichier de ressources.

Exigences

Exigence	Valeur
plateforme cible	Bureau
d’en-tête	winddiui.h (include Winddiui.h)
bibliothèque	Winspool.lib
DLL	WinSpool.drv