Función GdiEndPageEMF (winppi.h)

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 Comentarios.

Valor devuelto

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

Observaciones

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:

• Después de colocar 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 de 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, se habilita la optimización del color. Si dwOptimization se establece 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 imprimen en documentos negros y blancos. 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 dwColorOptimization miembro de las estructuras de ATTRIBUTE_INFO_2 o ATTRIBUTE_INFO_3. Esta optimización también se puede controlar mediante Unidrv *ChangeColorModeOnDoc? atributo de color (vea Atributos de color).

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

Requisitos

Requisito	Valor
de la plataforma de destino de	Universal
encabezado de	winppi.h (incluya Winppi.h)
biblioteca de	Gdi32.Lib
DLL de	Gdi32.dll

Consulte también

GdiPlayPageEMF

GdiStartPageEMF