Share via

DrvEndDoc-Funktion (winddi.h)

  • Artikel

Die DrvEndDoc-Funktion wird von GDI aufgerufen, wenn das Senden eines Dokuments an den Treiber zum Rendern abgeschlossen ist.

Syntax

BOOL DrvEndDoc(
  [in] SURFOBJ *pso,
  [in] FLONG   fl
);

Parameter

[in] pso

Vom Aufrufer bereitgestellter Zeiger auf eine SURFOBJ-Struktur .

[in] fl

Vom Aufrufer bereitgestellte Bitflags. Das folgende Flag wird definiert:

Flag Definition
ED_ABORTDOC Der Druckauftrag wird vor Abschluss beendet.

Rückgabewert

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

Hinweise

Eine Druckergrafik-DLL muss eine DrvEndDoc-Funktion bereitstellen. Die Funktion wird aufgerufen, nachdem die letzte physische Seite eines Druckauftrags gerendert wurde.

In der Regel wird die Funktion zum Senden von Steuersequenzen an Druckerhardware verwendet, nachdem ein Dokument gedruckt wurde, indem die EngWritePrinter-Funktion von GDI aufgerufen wird. Die Funktion kann auch interne, dokumentspezifische sauber-Up-Vorgänge für die Druckergrafik-DLL ausführen.

Da es keinen separaten Aufruf der Druckergrafik-DLL gibt, wenn ein Druckauftrag abgeschlossen ist, muss die DrvEndDoc-Funktion auch Steuersequenzen an den Drucker senden, um den Auftrag zu beenden, falls dies vom Drucker erforderlich ist. (Mit anderen Worten, es gibt ein Dokument pro Auftrag.)

Anforderungen

Anforderung Wert
Zielplattform Desktop
Kopfzeile winddi.h (einschließlich Winddi.h)

Weitere Informationen

DrvStartDoc