GdiEndPageEMF-Funktion (winppi.h)

Artikel
02/07/2025

Die GdiEndPageEMF--Funktion beendet EMF-Wiedergabevorgänge für eine physische Seite eines EMF-formatierten Druckauftrags.

Syntax

BOOL GdiEndPageEMF(
  HANDLE SpoolFileHandle,
  DWORD  dwOptimization
);

Parameter

SpoolFileHandle

Vom Aufrufer bereitgestellter Spooldateihandle, abgerufen durch einen vorherigen Aufruf von GdiGetSpoolFileHandle.

dwOptimization

Vom Aufrufer bereitgestellte Flags. Das folgende Kennzeichen ist definiert:

EMF_PP_COLOR_OPTIMIZATION

Aktivieren Sie die Farboptimierung. Weitere Informationen finden Sie in den Hinweisen.

Rückgabewert

Wenn der Vorgang erfolgreich ist, gibt die Funktion TRUEzurück. Andernfalls gibt die Funktion FALSE-zurück, und ein Fehlercode kann durch Aufrufen GetLastError-abgerufen werden.

Bemerkungen

Die GdiEndPageEMF--Funktion wird von gdi32.dll für die Verwendung innerhalb der PrintDocumentOnPrintProcessor Funktion eines Druckprozessors exportiert.

Die GdiEndPageEMF Funktion beendet die Verarbeitung einer physischen Seite und bewirkt, dass sie vom Drucker ausgeworfen wird. Ein Druckprozessor sollte GdiEndPageEMF- zu folgenden Zeiten aufrufen:

Nachdem die entsprechende Anzahl von Dokumentseiten auf der physischen Seite platziert wurde, indem Aufrufe an GdiPlayPageEMF. Beachten Sie, dass GdiPlayPageEMF- nicht tatsächlich im Gerätekontext gedruckt wird, sondern stattdessen eine Datenstruktur vorbereitet, die den Text und die Grafiken beschreibt, die auf den physischen Seiten gedruckt werden sollen. Der Text und die Grafiken werden im Gerätekontext gedruckt, wenn GdiEndPageEMF- aufgerufen wird.
Wenn ein Aufruf von GdiGetDevmodeForPage angibt, dass sich die DEVMODEW-Struktur einer Dokumentseite von der DEVMODE-Struktur der vorherigen Seite unterscheidet.

Wenn diese Funktion mit dem dwOptimization Parameter aufgerufen wird, der auf EMF_PP_COLOR_OPTIMIZATION festgelegt ist, wird die Farboptimierung aktiviert. Wenn dwOptimization- auf 0 festgelegt ist, wird keine Optimierung ausgeführt. Wenn die Farboptimierung aktiviert ist, wird das Vorhandensein der Farbe in der Spooldatei dazu führen, dass die Spooldatei in Farbe wiedergegeben wird. der Mangel an Farbe in der Spooldatei bewirkt, dass die Spooldatei in Monochrom wiedergegeben wird.

Wenn Sie ein Unidrv-Rendering-Plug-In zum Generieren von Farbwasserzeichen erstellen, sollten Sie darauf achten, dass Farbwasserzeichen schwarzweiß gedruckt werden, wenn sie auf Schwarzweißdokumenten gedruckt werden. Um sicherzustellen, dass Farbwasserzeichen mit Farben und Schwarzweißdokumenten korrekt gedruckt werden, deaktivieren Sie die Farboptimierung.

Die vom dwOptimization Parameter gesteuerte Farboptimierung kann auch durch Festlegen des dwColorOptimization Member der ATTRIBUTE_INFO_2 oder ATTRIBUTE_INFO_3 Strukturen gesteuert werden. Diese Optimierung kann auch von unidrv *ChangeColorModeOnDoc gesteuert werden? Farbattribute (siehe Farbattribute).

Weitere Informationen finden Sie unter Verwenden von GDI-Funktionen in Druckprozessoren.