Función OpenPrintProcessor (winsplp.h)

Artículo
02/27/2024

La función de un procesador de OpenPrintProcessor impresión prepara el procesador de impresión para imprimir un trabajo y devuelve un identificador.

Sintaxis

HANDLE OpenPrintProcessor(
  [in] LPWSTR                  pPrinterName,
  [in] PPRINTPROCESSOROPENDATA pPrintProcessorOpenData
);

Parámetros

[in] pPrinterName

Puntero proporcionado por el autor de la llamada al nombre de la impresora para la que se abre el procesador de impresión.

[in] pPrintProcessorOpenData

Puntero proporcionado por el autor de la llamada a una estructura PRINTPROCESSOROPENDATA .

Valor devuelto

Si la operación se realiza correctamente, la función debe devolver un identificador que se puede usar como argumento de entrada para las llamadas posteriores a PrintDocumentOnPrintProcessor, ControlPrintProcessor y ClosePrintProcessor. 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 NULL.

Comentarios

Los procesadores de impresión son necesarios para exportar una OpenPrintProcessor función. El administrador de colas llama a la función cuando hay disponible un trabajo de impresión. La función debe realizar operaciones de inicialización necesarias para que se pueda procesar un trabajo, en función del tipo de datos del trabajo.

La función debe devolver un identificador. Normalmente, el identificador es un puntero a una estructura interna. La estructura debe contener un puntero al nombre de la impresora y un puntero a la estructura DEVMODEW de la impresora, ambos recibidos en la estructura PRINTPROCESSOROPENDATA . La función PrintDocumentOnPrintProcessor del procesador de impresión requiere estos dos punteros y esta última función recibe el identificador como entrada cuando el colador lo llama.