ControlPrintProcessor, fonction (winsplp.h)
La fonction ControlPrintProcessor d’un processeur d’impression permet au spouleur de contrôler un travail d’impression.
Syntaxe
BOOL ControlPrintProcessor(
[in] HANDLE hPrintProcessor,
[in] DWORD Command
);
Paramètres
[in] hPrintProcessor
Handle du processeur d’impression fourni par l’appelant. Il s’agit du handle retourné par un appel précédent à OpenPrintProcessor.
[in] Command
Commande fournie par l’appelant indiquant le type d’opération à effectuer. Les commandes suivantes sont valides :
| Commander | Définition |
|---|---|
| JOB_CONTROL_CANCEL | La fonction doit annuler le travail d’impression actuel. |
| JOB_CONTROL_PAUSE | La fonction doit suspendre le travail d’impression actuel. |
| JOB_CONTROL_RESUME | La fonction doit reprendre le travail d’impression actuel. |
Valeur de retour
Si l’opération réussit, la fonction doit retourner TRUE. Si l’opération échoue, la fonction doit appeler SetLastError pour définir un code d’erreur, puis retourner FALSE.
Remarques
Les processeurs d’impression sont nécessaires pour exporter une fonction ControlPrintProcessor. Le spouleur appelle la fonction lorsqu’une application appelle la fonction SetJob, décrite dans la documentation du Kit de développement logiciel (SDK) Microsoft Windows.
En fonction de la valeur reçue pour Commande, la fonction doit soit suspendre, reprendre ou annuler le travail actuel. La fonction ControlPrintProcessor peut être appelée de manière asynchrone pendant l’exécution de la fonction PrintDocumentOnPrintProcessor du processeur d’impression. Par conséquent, une technique de synchronisation doit être utilisée, par exemple la définition d’un objet d’événement défini en interne pour suspendre un travail et réinitialiser l’objet d’événement lors de la reprise du travail. La fonction ControlPrintProcessor peut rapidement retourner après avoir défini ou réinitialisé l’objet d’événement, et PrintDocumentOnPrintProcessor peut attendre que l’événement soit dans l’état approprié.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Bureau |
| d’en-tête | winsplp.h (include Winsplp.h) |
| bibliothèque | Nwprint.lib |