PrintDocumentOnPrintProcessor, fonction (winsplp.h)
La fonction PrintDocumentOnPrintProcessor d’un processeur d’impression convertit un travail d’impression à partir d’un format mis en pool en données brutes qui peuvent être envoyées à un moniteur d’impression.
Syntaxe
BOOL PrintDocumentOnPrintProcessor(
[in] HANDLE hPrintProcessor,
[in] LPWSTR pDocumentName
);
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] pDocumentName
Pointeur fourni par l’appelant vers le nom du document.
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 PrintDocumentOnPrintProcessor. Le spouleur appelle la fonction après avoir appelé OpenPrintProcessor. L’objectif de la fonction est de lire le contenu du fichier nommé par pDocumentName, de convertir (si nécessaire) les données du fichier en flux de données qui peuvent être lues par le matériel de l’imprimante et d’envoyer le flux de données au spouleur. Le spouleur peut ensuite envoyer le flux de données au moniteur d’impression approprié.
Si le format d’entrée est EMF du système d’exploitation basé sur NT, la fonction PrintDocumentOnPrintProcessor peut appeler fonctions GDI pour les processeurs d’impression. Pour plus d’informations, consultez Traitement d’un travail d’impression.
Le flux de données converti doit être renvoyé au spouleur en appelant WritePrinter, qui est décrit dans la documentation du Kit de développement logiciel (SDK) Microsoft Windows. Pour plus d’informations, consultez Traitement d’un travail d’impression.
La fonction PrintDocumentOnPrintProcessor doit être écrite pour gérer les demandes de pause, de reprise ou d’annulation du travail d’impression. Pour plus d’informations, consultez ControlPrintProcessor.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Bureau |
| d’en-tête | winsplp.h (include Winsplp.h) |
| bibliothèque | Nwprint.lib |