Función GdiEndPageEMF (winppi.h)

Artículo
03/08/2023

La función GdiEndPageEMF finaliza las operaciones de reproducción EMF para una página física de un trabajo de impresión con formato EMF.

Sintaxis

BOOL GdiEndPageEMF(
  HANDLE SpoolFileHandle,
  DWORD  dwOptimization
);

Parámetros

SpoolFileHandle

Identificador de archivo de cola proporcionado por el autor de la llamada, obtenido por una llamada anterior a GdiGetSpoolFileHandle.

dwOptimization

Marcas proporcionadas por el autor de la llamada. Se define la marca siguiente:

EMF_PP_COLOR_OPTIMIZATION

Habilite la optimización de colores. Para obtener más información, vea la sección Comentarios.

Valor devuelto

Si la operación se realiza correctamente, la función devuelve TRUE. De lo contrario, la función devuelve FALSE y se puede obtener un código de error llamando a GetLastError.

Comentarios

La función GdiEndPageEMF se exporta mediante gdi32.dll para su uso en la función PrintDocumentOnPrintProcessor de un procesador de impresión.

La función GdiEndPageEMF finaliza el procesamiento de una página física y hace que se expulse de la impresora. Un procesador de impresión debe llamar a GdiEndPageEMF en los momentos siguientes:

Una vez que se haya colocado el número adecuado de páginas de documento en la página física, realice llamadas a GdiPlayPageEMF. Tenga en cuenta que GdiPlayPageEMF no imprime realmente en el contexto del dispositivo, sino que prepara una estructura de datos que describe el texto y los gráficos que se van a imprimir en las páginas físicas. El texto y los gráficos se imprimen en el contexto del dispositivo cuando se llama a GdiEndPageEMF .
Cada vez que una llamada a GdiGetDevmodeForPage indica que la estructura DEVMODEW de una página de documento es diferente de la estructura DEVMODE de la página anterior.

Si se llama a esta función con el parámetro dwOptimization establecido en EMF_PP_COLOR_OPTIMIZATION, la optimización de colores está habilitada. Si dwOptimization está establecido en 0, no se realiza ninguna optimización. Cuando se habilita la optimización de color, la presencia de color en el archivo de cola hace que el archivo de cola se reproduzca en color; La falta de color en el archivo de cola hace que el archivo de cola se reproduzca en monocromo.

Si va a crear un complemento de representación Unidrv para generar marcas de agua de color, tenga en cuenta que la optimización del color hace que las marcas de agua de color se impriman en blanco y negro cuando se impriman en documentos en blanco y negro. Para asegurarse de que las marcas de agua de color se imprimen correctamente con documentos de color y blanco y negro, deshabilite la optimización del color.

La optimización de color controlada por el parámetro dwOptimization también se puede controlar estableciendo el miembro dwColorOptimization de las estructuras de ATTRIBUTE_INFO_2 o ATTRIBUTE_INFO_3 . Esta optimización también se puede controlar mediante el atributo de color Unidrv *ChangeColorModeOnDoc( vea Atributos de color).

Para obtener más información, consulte Uso de funciones GDI en procesadores de impresión.