PrintDocumentOnPrintProcessor-Funktion (winsplp.h)
Die Funktion eines PrintDocumentOnPrintProcessor Druckprozessors konvertiert einen Druckauftrag aus einem gepoolten Format in Rohdaten, die an einen Druckmonitor gesendet werden können.
Syntax
BOOL PrintDocumentOnPrintProcessor(
[in] HANDLE hPrintProcessor,
[in] LPWSTR pDocumentName
);
Parameter
[in] hPrintProcessor
Vom Aufrufer bereitgestellter Druckprozessorhandle. Dies ist das Handle, das von einem vorherigen Aufruf von OpenPrintProcessor zurückgegeben wurde.
[in] pDocumentName
Vom Aufrufer bereitgestellter Zeiger auf den Dokumentnamen.
Rückgabewert
Wenn der Vorgang erfolgreich ist, sollte die Funktion TRUE zurückgeben. Wenn der Vorgang fehlschlägt, sollte die Funktion SetLastError aufrufen, um einen Fehlercode festzulegen, und dann FALSE zurückgeben.
Hinweise
Druckprozessoren sind erforderlich, um eine PrintDocumentOnPrintProcessor Funktion zu exportieren. Der Spooler ruft die Funktion nach dem Aufruf von OpenPrintProcessor auf. Der Zweck der Funktion besteht darin, den Inhalt der Datei mit dem Namen pDocumentName zu lesen, die Daten der Datei (falls erforderlich) in einen Datenstrom zu konvertieren, der von Druckerhardware gelesen werden kann, und den Datenstrom zurück an den Spooler zu senden. Der Spooler kann dann den Datenstrom an den entsprechenden Druckmonitor senden.
Wenn das Eingabeformat NT-basiertes Betriebssystem EMF ist, kann die PrintDocumentOnPrintProcessor Funktion GDI-Funktionen für Druckprozessoren aufrufen. Weitere Informationen finden Sie unter Verarbeiten eines Druckauftrags.
Der konvertierte Datenstrom muss zurück an den Spooler gesendet werden, indem WritePrinter aufgerufen wird, was in der Microsoft Windows SDK-Dokumentation beschrieben wird. Weitere Informationen finden Sie unter Verarbeiten eines Druckauftrags.
Die PrintDocumentOnPrintProcessor Funktion muss geschrieben werden, um Anforderungen zum Anhalten, Fortsetzen oder Abbrechen des Druckauftrags zu verarbeiten. Weitere Informationen finden Sie unter ControlPrintProcessor.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Desktop |
| Kopfzeile | winsplp.h (winsplp.h einschließen) |
| Bibliothek | Nwprint.lib |