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

Voir aussi

ControlPrintProcessor

OpenPrintProcessor