Función EndPage (wingdi.h)

  • Artículo

La función EndPage notifica al dispositivo que la aplicación ha terminado de escribir en una página. Esta función se usa normalmente para dirigir al controlador de dispositivo para avanzar a una nueva página.

Sintaxis

int EndPage(
  [in] HDC hdc
);

Parámetros

[in] hdc

Identificador del contexto del dispositivo para el trabajo de impresión.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es mayor que cero.

Si se produce un error en la función, el valor devuelto es menor o igual que cero.

Comentarios

Nota Se trata de una función de bloqueo o sincrónica que podría no devolverse inmediatamente. La rapidez con la que esta función devuelve depende de factores en tiempo de ejecución, como el estado de red, la configuración del servidor de impresión y la implementación del controlador de impresora, factores que son difíciles de predecir al escribir una aplicación. Llamar a esta función desde un subproceso que administra la interacción con la interfaz de usuario podría hacer que la aplicación parezca que no responde.
 
Use la función ResetDC para cambiar el modo de dispositivo, si es necesario, después de llamar a la función EndPage . Tenga en cuenta que una llamada a ResetDC restablece todos los atributos de contexto del dispositivo a los valores predeterminados. EndPage ni StartPage restablecen los atributos de contexto del dispositivo. Los atributos de contexto del dispositivo permanecen constantes en las páginas posteriores. No es necesario volver a seleccionar objetos y volver a configurar el modo de asignación antes de imprimir la página siguiente; sin embargo, al hacerlo, se producirán los mismos resultados y se reducirán las diferencias de código entre las versiones de Windows.

Cuando una página de un archivo en cola supera aproximadamente 350 MB, puede no imprimirse y no enviar un mensaje de error. Por ejemplo, esto puede ocurrir al imprimir archivos EMF grandes. El límite de tamaño de página depende de muchos factores, como la cantidad de memoria virtual disponible, la cantidad de memoria asignada mediante la llamada a procesos y la cantidad de fragmentación en el montón del proceso.

Ejemplos

Para ver un programa de ejemplo que usa esta función, consulte How To: Print Using the GDI Print API.

Requisitos

   
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado wingdi.h (incluye Windows.h)
Library Gdi32.lib
Archivo DLL Gdi32.dll

Consulte también

Funciones de la API del administrador de trabajos de impresión

Impresión

ResetDC

StartPage