Función PrintDocumentOnPrintProcessor (winsplp.h)
La función PrintDocumentOnPrintProcessor de un 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.
Observaciones
Los procesadores de impresión son necesarios para exportar una función PrintDocumentOnPrintProcessor. El colador 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 el hardware de la impresora puede leer y enviar el flujo de datos de vuelta al administrador de colas. 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 función PrintDocumentOnPrintProcessor puede llamar a funciones GDI para procesadores de impresión. Para obtener más información, vea Procesar un trabajo de impresión.
El flujo de datos convertido se debe devolver al colador llamando a WritePrinter, que se describe en la documentación del SDK de Microsoft Windows. Para obtener más información, vea Procesar un trabajo de impresión.
La función PrintDocumentOnPrintProcessor 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 | Valor |
|---|---|
| de la plataforma de destino de | Escritorio |
| encabezado de | winsplp.h (incluya Winsplp.h) |
| biblioteca de | Nwprint.lib |