Función StartPagePrinter

La función StartPagePrinter notifica al colador que una página está a punto de imprimirse en la impresora especificada.

Sintaxis

BOOL StartPagePrinter(
  _In_ HANDLE hPrinter
);

Parámetros

hPrinter [in]

Maneje a una impresora. Use la función OpenPrinter o AddPrinter para recuperar un identificador de impresora.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es un valor distinto de cero.

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

Observaciones

La secuencia de un trabajo de impresión es la siguiente:

1. Para iniciar un trabajo de impresión, llame a StartDocPrinter.
2. Para comenzar cada página, llame a StartPagePrinter.
3. Para escribir datos en una página, llame a WritePrinter.
4. Para finalizar cada página, llame a EndPagePrinter.
5. Repita 2, 3 y 4 para tantas páginas como sea necesario.
6. Para finalizar el trabajo de impresión, llame a EndDocPrinter.

Cuando una página de un archivo en cola supera aproximadamente 350 MB, puede no imprimir 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 obtener un programa de ejemplo que use esta función, consulte How To: Print Using the GDI Print API.

Requisitos

Consulte también

Impresión

de funciones de API de administrador de trabajos de impresión

EndDocPrinter de

endPagePrinter de

OpenPrinter

startDocPrinter de

WritePrinter de