Freigeben über


PrintDocumentOnPrintProcessor-Funktion (winsplp.h)

Die PrintDocumentOnPrintProcessor-Funktion eines Druckprozessors wandelt einen Druckauftrag aus einem gepoolten Format in Rohdaten um, die an einen Druckmonitor gesendet werden können.

Syntax

BOOL PrintDocumentOnPrintProcessor(
  [in] HANDLE hPrintProcessor,
  [in] LPWSTR pDocumentName
);

Parameter

[in] hPrintProcessor

Vom Anrufer bereitgestellter Druckprozessorhandle. Dies ist das Handle, das von einem vorherigen Aufruf von OpenPrintProcessorzurückgegeben wird.

[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.

Bemerkungen

Druckprozessoren müssen eine PrintDocumentOnPrintProcessor Funktion exportieren. Der Spooler ruft die Funktion nach dem Aufruf OpenPrintProcessorauf. Der Zweck der Funktion besteht darin, den Inhalt der Von pDocumentNamebenannten Datei zu lesen, die Daten der Datei (falls erforderlich) in einen Datenstrom zu konvertieren, der von der Druckerhardware gelesen werden kann, und den Datenstrom zurück an den Spooler zu senden. Der Spooler kann dann den Datenstrom an den entsprechenden Druckmonitorsenden.

Wenn das Eingabeformat NT-basiertes Betriebssystem EMF ist, kann die PrintDocumentOnPrintProcessor-Funktion GDI-Funktionen für Druckprozessorenaufrufen. Weitere Informationen finden Sie unter Verarbeiten eines Druckauftrags.

Der konvertierte Datenstrom muss durch Aufrufen von WritePrinter-an den Spooler zurückgesendet werden, der 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
Header- winsplp.h (include Winsplp.h)
Library Nwprint.lib

Siehe auch

ControlPrintProcessor-

OpenPrintProcessor-