EndPage-Funktion (wingdi.h)

Die EndPage-Funktion benachrichtigt das Gerät, dass die Anwendung das Schreiben auf eine Seite abgeschlossen hat. Diese Funktion wird in der Regel verwendet, um den Gerätetreiber anweisen, zu einer neuen Seite zu wechseln.

Syntax

int EndPage(
  [in] HDC hdc
);

Parameter

[in] hdc

Ein Handle für den Gerätekontext für den Druckauftrag.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert größer als 0 (null).

Wenn die Funktion fehlschlägt, ist der Rückgabewert kleiner oder gleich 0.

Hinweise

Hinweis Dies ist eine blockierende oder synchrone Funktion, die möglicherweise nicht sofort zurückgegeben wird. Wie schnell diese Funktion zurückgibt, hängt von Laufzeitfaktoren wie Netzwerk-status, Druckerserverkonfiguration und Druckertreiberimplementierung ab– Faktoren, die beim Schreiben einer Anwendung schwer vorherzusagen sind. Das Aufrufen dieser Funktion aus einem Thread, der die Interaktion mit der Benutzeroberfläche verwaltet, könnte dazu führen, dass die Anwendung nicht mehr reagiert.

 

Verwenden Sie die ResetDC-Funktion , um den Gerätemodus nach Dem Aufruf der EndPage-Funktion bei Bedarf zu ändern. Beachten Sie, dass bei einem Aufruf von ResetDC alle Gerätekontextattribute auf die Standardwerte zurückgesetzt werden. Weder EndPage noch StartPage setzen die Gerätekontextattribute zurück. Gerätekontextattribute bleiben auf nachfolgenden Seiten konstant. Sie müssen Objekte nicht erneut auswählen und den Zuordnungsmodus erneut einrichten, bevor Sie die nächste Seite drucken. Dies führt jedoch zu den gleichen Ergebnissen und verringert die Codeunterschiede zwischen den Versionen von Windows.

Wenn eine Seite in einer Spooldatei ungefähr 350 MB überschreitet, kann sie möglicherweise nicht gedruckt werden und keine Fehlermeldung senden. Dies kann beispielsweise beim Drucken großer EMF-Dateien auftreten. Der Grenzwert für die Seitengröße hängt von vielen Faktoren ab, einschließlich der Menge des verfügbaren virtuellen Arbeitsspeichers, der Durch aufrufende Prozesse zugewiesenen Arbeitsspeichermenge und der Fragmentierung im Prozessheap.

Beispiele

Ein Beispielprogramm, das diese Funktion verwendet, finden Sie unter Vorgehensweise: Drucken mithilfe der GDI-Druck-API.

Anforderungen

Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	wingdi.h (windows.h einschließen)
Bibliothek	Gdi32.lib
DLL	Gdi32.dll

Weitere Informationen

Druckspooler-API-Funktionen

Drucken

ResetDC

StartPage