GdiEndPageEMF-Funktion (winppi.h)

Artikel
02/27/2024

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 bereitgestelltes Spooldateihandle, das durch einen vorherigen Aufruf von GdiGetSpoolFileHandle abgerufen wurde.

dwOptimization

Vom Aufrufer bereitgestellte Flags. Das folgende Flag 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 TRUE zurück. Andernfalls gibt die Funktion FALSE zurück, und ein Fehlercode kann durch Aufrufen von GetLastError abgerufen werden.

Hinweise

Die GdiEndPageEMF-Funktion wird von gdi32.dll zur Verwendung in der PrintDocumentOnPrintProcessor-Funktion eines Druckprozessors exportiert.

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

Nachdem die entsprechende Anzahl von Dokumentseiten auf der physischen Seite platziert wurde, indem Sie GdiPlayPageEMF aufrufen. Beachten Sie, dass GdiPlayPageEMF nicht tatsächlich im Gerätekontext druckt, 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 ausgegeben, 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 aufgerufen wird, wobei der dwOptimization-Parameter 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, führt das Vorhandensein von Farbe in der Spooldatei dazu, dass die Spooldatei in Farbe wiedergegeben wird. der Farbmangel in der Spooldatei bewirkt, dass die Spooldatei monochrom wiedergegeben wird.

Wenn Sie ein Unidrv-Rendering-Plug-In zum Generieren von Farbwasserzeichen erstellen, sollten Sie beachten, dass die Farboptimierung dazu führt, dass Farbwasserzeichen schwarzweiß gedruckt werden, wenn sie auf Schwarzweißdokumenten gedruckt werden. Deaktivieren Sie die Farboptimierung, um sicherzustellen, dass Farbwasserzeichen ordnungsgemäß mit Farb- und Schwarzweißdokumenten gedruckt werden.

Die durch den dwOptimization-Parameter gesteuerte Farboptimierung kann auch durch Festlegen des dwColorOptimization-Elements der ATTRIBUTE_INFO_2- oder ATTRIBUTE_INFO_3-Strukturen gesteuert werden. Diese Optimierung kann auch über das Unidrv *ChangeColorModeOnDoc?- Farbattribute gesteuert werden (siehe Farbattribute).

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