Fonction PrintDocumentOnPrintProcessor (winsplp.h)
La fonction d’un PrintDocumentOnPrintProcessor processeur d’impression convertit un travail d’impression d’un format 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
Poignée du processeur d’impression fournie 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 retournée
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 PrintDocumentOnPrintProcessor fonction. 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 un flux de données pouvant être lu par le matériel d’imprimante et de renvoyer 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 NT, la PrintDocumentOnPrintProcessor fonction peut appeler des 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 Microsoft Windows SDK. Pour plus d’informations, consultez Traitement d’un travail d’impression.
La PrintDocumentOnPrintProcessor fonction doit être écrite pour gérer les demandes de suspension, de reprise ou d’annulation du travail d’impression. Pour plus d’informations, consultez ControlPrintProcessor.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Desktop (Expérience utilisateur) |
| En-tête | winsplp.h (inclure Winsplp.h) |
| Bibliothèque | Nwprint.lib |