OpenPrintProcessor-Funktion (winsplp.h)

Artikel
02/27/2024

Die Funktion eines OpenPrintProcessor Druckprozessors bereitet den Druckprozessor auf das Drucken eines Auftrags vor und gibt einen Ziehpunkt zurück.

Syntax

HANDLE OpenPrintProcessor(
  [in] LPWSTR                  pPrinterName,
  [in] PPRINTPROCESSOROPENDATA pPrintProcessorOpenData
);

Parameter

[in] pPrinterName

Vom Aufrufer bereitgestellter Zeiger auf den Namen des Druckers, für den der Druckprozessor geöffnet wird.

[in] pPrintProcessorOpenData

Vom Aufrufer bereitgestellter Zeiger auf eine PRINTPROCESSOROPENDATA-Struktur .

Rückgabewert

Wenn der Vorgang erfolgreich ist, sollte die Funktion ein Handle zurückgeben, das als Eingabeargument für nachfolgende Aufrufe von PrintDocumentOnPrintProcessor, ControlPrintProcessor und ClosePrintProcessor verwendet werden kann. Wenn der Vorgang fehlschlägt, sollte die Funktion SetLastError aufrufen, um einen Fehlercode festzulegen, und dann NULL zurückgeben.

Hinweise

Druckprozessoren sind erforderlich, um eine OpenPrintProcessor Funktion zu exportieren. Der Spooler ruft die Funktion auf, wenn ein Druckauftrag verfügbar ist. Die Funktion sollte Initialisierungsvorgänge ausführen, die erforderlich sind, bevor ein Auftrag verarbeitet werden kann, basierend auf dem Datentyp des Auftrags.

Die Funktion muss ein Handle zurückgeben. In der Regel ist das Handle ein Zeiger auf eine interne Struktur. Die -Struktur muss einen Zeiger auf den Namen des Druckers und einen Zeiger auf die DEVMODEW-Struktur des Druckers enthalten, die beide in der PRINTPROCESSOROPENDATA-Struktur empfangen werden. Diese beiden Zeiger werden von der PrintDocumentOnPrintProcessor-Funktion des Druckprozessors benötigt, und diese letztere Funktion empfängt das Handle als Eingabe, wenn der Spooler es aufruft.