DrvSendPage-Funktion (winddi.h)

Artikel
08/27/2023

Die DrvSendPage-Funktion einer Druckergrafik-DLL wird von GDI aufgerufen, wenn das Zeichnen einer physischen Seite abgeschlossen ist, sodass der Treiber die Seite an den Drucker senden kann.

Syntax

BOOL DrvSendPage(
  [in] SURFOBJ *pso
);

Parameter

[in] pso

Vom Aufrufer bereitgestellter Zeiger auf eine SURFOBJ-Struktur , die die Zeichnungsoberfläche beschreibt.

Rückgabewert

Wenn der Vorgang erfolgreich ist, sollte die Funktion TRUE zurückgeben. Andernfalls sollte die Win32 SetLastError-Funktion aufgerufen werden, um einen Fehlercode festzulegen, und dann FALSE zurückgeben.

Hinweise

GDI ruft DrvSendPage jedes Mal auf, wenn das Zeichnen des Bilds einer physischen Seite auf der Zeichnungsoberfläche abgeschlossen ist. Die Funktion ist für den Aufruf von EngWritePrinter verantwortlich, um das Bild an den Drucker zu senden, und für die Ausführung von Seitenendevorgängen, z. B. das Auswerfen der Seite.

Druckergrafik-DLLs mit GDI-verwalteten Oberflächen werden in der Regel implementiert, sodass für seiten, die gebändert sind, das Bild für jedes Band von der DrvNextBand-Funktion des Treibers an den Drucker gesendet wird.

Wenn eine Druckergrafik-DLL eine geräteseitig verwaltete Oberfläche verwendet, muss die DrvSendPage-Funktion in der Regel nur End-of-Page-Vorgänge ausführen, da das Bild beim Zeichnen an den Drucker gesendet wird.

Wenn die Ausführung dieser Funktion möglicherweise lange dauert, sollte sie alle fünf Sekunden EngCheckAbort aufrufen. Wenn EngCheckAbortTRUE zurückgibt, sollte DrvSendPage den Vorgang beenden und FALSE zurückgeben.