Función PrintDocumentOnPrintProcessor (winsplp.h)

Una función del PrintDocumentOnPrintProcessor procesador de impresión convierte un trabajo de impresión de un formato en cola en datos sin procesar que se pueden enviar a un monitor de impresión.

Sintaxis

BOOL PrintDocumentOnPrintProcessor(
  [in] HANDLE hPrintProcessor,
  [in] LPWSTR pDocumentName
);

Parámetros

[in] hPrintProcessor

Controlador de procesador de impresión proporcionado por el autor de la llamada. Este es el identificador devuelto por una llamada anterior a OpenPrintProcessor.

[in] pDocumentName

Puntero proporcionado por el autor de la llamada al nombre del documento.

Valor devuelto

Si la operación se realiza correctamente, la función debe devolver TRUE. Si se produce un error en la operación, la función debe llamar a SetLastError para establecer un código de error y, a continuación, devolver FALSE.

Comentarios

Los procesadores de impresión son necesarios para exportar una PrintDocumentOnPrintProcessor función. El administrador de colas llama a la función después de llamar a OpenPrintProcessor. El propósito de la función es leer el contenido del archivo denominado por pDocumentName, convertir (si es necesario) los datos del archivo en un flujo de datos que puede leer el hardware de la impresora y devolver el flujo de datos al administrador de trabajos. Después, el administrador de colas puede enviar el flujo de datos al monitor de impresión adecuado.

Si el formato de entrada es EMF del sistema operativo basado en NT, la PrintDocumentOnPrintProcessor función puede llamar a funciones GDI para procesadores de impresión. Para obtener más información, consulte Procesamiento de un trabajo de impresión.

El flujo de datos convertido debe devolverse al administrador de trabajos de cola mediante una llamada a WritePrinter, que se describe en la documentación de Microsoft Windows SDK. Para obtener más información, consulte Procesamiento de un trabajo de impresión.

La PrintDocumentOnPrintProcessor función debe escribirse para controlar las solicitudes para pausar, reanudar o cancelar el trabajo de impresión. Para obtener más información, vea ControlPrintProcessor.

Requisitos

Requisito	Value
Plataforma de destino	Escritorio
Encabezado	winsplp.h (incluya Winsplp.h)
Library	Nwprint.lib

Consulte también

ControlPrintProcessor

OpenPrintProcessor