DrvEndDoc-Funktion (winddi.h)
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) |