Funzione GdiEndPageEMF (winppi.h)

Articolo
08/08/2023

La funzione GdiEndPageEMF termina le operazioni di riproduzione EMF per una pagina fisica di un processo di stampa formattato da EMF.

Sintassi

BOOL GdiEndPageEMF(
  HANDLE SpoolFileHandle,
  DWORD  dwOptimization
);

Parametri

SpoolFileHandle

Handle di file spool fornito dal chiamante, ottenuto da una chiamata precedente a GdiGetSpoolFileHandle.

dwOptimization

Flag forniti dal chiamante. Il flag seguente è definito:

EMF_PP_COLOR_OPTIMIZATION

Abilitare l'ottimizzazione dei colori. Per altre informazioni, vedere la sezione Osservazioni.

Valore restituito

Se l'operazione ha esito positivo, la funzione restituisce TRUE. In caso contrario, la funzione restituisce FALSE e un codice di errore può essere ottenuto chiamando GetLastError.

Commenti

La funzione GdiEndPageEMF viene esportata da gdi32.dll per l'uso all'interno della funzione PrintDocumentOnPrintProcessor di un processore di stampa.

La funzione GdiEndPageEMF termina l'elaborazione di una pagina fisica e la causa l'espulsa dalla stampante. Un processore di stampa deve chiamare GdiEndPageEMF negli orari seguenti:

Dopo aver inserito il numero appropriato di pagine del documento nella pagina fisica eseguendo chiamate a GdiPlayPageEMF. Si noti che GdiPlayPageEMF non stampa effettivamente nel contesto del dispositivo, ma prepara una struttura di dati che descrive il testo e la grafica da stampare nelle pagine fisiche. Il testo e la grafica vengono stampati nel contesto del dispositivo quando viene chiamato GdiEndPageEMF .
Ogni volta che una chiamata a GdiGetDevmodeForPage indica che la struttura DEVMODEW della pagina del documento è diversa dalla struttura DEVMODE della pagina precedente.

Se questa funzione viene chiamata con il parametro dwOptimization impostato su EMF_PP_COLOR_OPTIMIZATION, l'ottimizzazione del colore è abilitata. Se dwOptimization è impostato su 0, non viene eseguita alcuna ottimizzazione. Quando l'ottimizzazione dei colori è abilitata, la presenza di colore nel file di spool fa sì che il file di spool venga riprodotto in colore; la mancanza di colore nel file di spool fa sì che il file di spool venga riprodotto in monocromia.

Se si sta creando un plug-in di rendering Unidrv per generare filigrane di colori, si consiglia che l'ottimizzazione dei colori causa la stampa di filigrane di colore in nero e bianco quando vengono stampati su documenti neri e bianchi. Per garantire che le filigrane di colore vengano stampate correttamente con documenti di colore e nero e bianco, disabilitare l'ottimizzazione dei colori.

L'ottimizzazione dei colori controllata dal parametro dwOptimization può essere controllata anche impostando il membro dwColorOptimization delle strutture ATTRIBUTE_INFO_2 o ATTRIBUTE_INFO_3. Questa ottimizzazione può essere controllata anche dall'attributo colore Unidrv *ChangeColorModeOnDoc? (vedere Attributi colore).

Per altre informazioni, vedere Uso di funzioni GDI nei processori di stampa.