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

Weitere Informationen

ControlPrintProcessor

OpenPrintProcessor