Compartir a través de

Funciones definidas por proveedores de impresión

Warning

A partir de Windows 10, las API que admiten proveedores de impresión de terceros están en desuso. Microsoft no recomienda ninguna inversión en proveedores de impresión de terceros. Además, en Windows 8 y productos más recientes en los que el modelo de controlador de impresión v4 está disponible, es posible que los proveedores de impresión de terceros no creen o administren colas que usan controladores de impresión v4.

En este tema se enumeran todas las funciones que puede proporcionar un proveedor de impresión. La mayoría de estas funciones se describen en la documentación del SDK de Microsoft Windows. Si la función se describe en el Kit de controladores de Windows (WDK), el nombre de la función proporciona un vínculo a la página de referencia asociada.

Todos los proveedores de impresión deben proporcionar punteros para todas las funciones enumeradas. Sin embargo, la mayoría de los proveedores de impresión proporcionados por el proveedor son "proveedores parciales" que no necesitan admitir muchas de las operaciones definidas por las funciones. Therefore, many of the function pointers can be NULL. Para obtener más información sobre los proveedores de impresión parciales, consulte Escritura de un proveedor de impresión de red.

En las listas de funciones siguientes, las funciones que se deben admitir se etiquetan como "Requeridas".

All print providers must export the initialization function, InitializePrintProvidor. Pointers to all the other functions must be supplied in a PRINTPROVIDOR structure. (Tenga en cuenta que estos dos nombres están mal escritos, pero son coherentes con los nombres que aparecen en el archivo de encabezado, Winsplp.h).

Las funciones se dividen en grupos y se presentan en las secciones siguientes:

  • Initialization function

  • Funciones de administración de colas de impresión

  • Funciones de administración de controladores de impresora

  • Funciones de creación de trabajos de impresión

  • Funciones de programación de trabajos de impresión

  • Funciones de administración de formularios

  • Funciones de administración del procesador de impresión

  • Funciones de administración del monitor de impresión

  • Funciones de administración de puertos

  • Funciones de administración del Registro

  • Other functions

Initialization function

Function Description
InitializePrintProvidor (Required) Inicializa el proveedor de impresión y devuelve punteros a las funciones proporcionadas.
Function Description
AddPrinter Agrega una cola de impresión a la lista de los administrados por el proveedor de impresión y asocia un procesador de impresión a la cola de impresión.
AddPrinterConnection Crea una conexión a la cola de impresión especificada.
ClosePrinter (Required) Deshabilita el acceso del autor de la llamada a una cola de impresión especificada.
DeletePrinter Elimina una cola de impresión de la lista de los administrados por el proveedor de impresión.
DeletePrinterConnection Quita una conexión a la cola de impresión especificada.
EnumPrinters (Required) Enumera la lista de colas de impresión administradas actualmente por el proveedor de impresión.
FindClosePrinterChangeNotification Disables printer change notifications that were enabled by FindFirstPrinterChangeNotification.
FindFirstPrinterChangeNotification Devuelve un identificador a un objeto de espera que el autor de la llamada puede usar para esperar eventos de impresora especificados.
GetPrinter (Required) Devuelve los valores de parámetro actuales de una cola de impresión especificada.
OpenPrinter (Required) Habilita el acceso del autor de la llamada a una cola de impresión especificada.
RefreshPrinterChangeNotification Called by router if client calls FindNextPrinterChangeNotification with the PRINTER_NOTIFY_OPTIONS_REFRESH flag set.
ResetPrinter Modifies a print queue's data type or DEVMODEW structure.
SetPrinter (Required) Establece parámetros para una cola de impresión especificada.
WaitForPrinterChange Obsolete.

Funciones de administración de controladores de impresora

Function Description
AddPrinterDriver Agrega los archivos de controlador de una impresora especificada a un servidor especificado.
AddPrinterDriverEx Same as AddPrinterDriver, with additional parameters.
DeletePrinterDriver Elimina el acceso a los archivos de controlador de una impresora especificada, en un servidor especificado.
DeletePrinterDriverEx Same as DeletePrinterDriver, with additional parameters.
EnumPrinterDrivers Returns a list of printer drivers that have been added to a specified server by calling AddPrinterDriver or AddPrinterDriverEx.
GetPrinterDriver Returns information about a printer driver, which the caller can then pass to AddPrinterDriver. (La información devuelta se obtiene normalmente de un archivo INF).
[GetPrinterDriverEx Same as GetPrinterDriver, with additional parameters.
GetPrinterDriverDirectory Devuelve el nombre del directorio del controlador de impresora del servidor.
Function Description
AbortPrinter (Required) Intenta eliminar el trabajo actual de la cola de impresión especificada.
AddJob (Required) Devuelve un identificador de trabajo y una ruta de acceso de archivo de cola. The caller uses CreateFile and WriteFile to send data to the spool file.
EndDocPrinter (Required) Realiza operaciones de finalización del trabajo.
EndPagePrinter Realiza operaciones de finalización de páginas.
ReadPrinter Obtiene información de estado de una impresora bidireccional.
ScheduleJob (Required) Informa al proveedor de que se puede programar un trabajo especificado. The job is specified by a job identifier previously returned by AddJob.
StartDocPrinter (Required) Prepara el proveedor de impresión para empezar a poner en cola un trabajo de impresión.
StartPagePrinter Prepara el proveedor de impresión para recibir una página de trabajo de impresión.
WritePrinter (Required) Recibe una parte del flujo de datos del trabajo de impresión.

Note

The AddJob...ScheduleJob sequence is an alternative to the StartDocPrinter...EndDocPrinter sequence.

Function Description
EnumJobs (Required) Devuelve una lista de trabajos de impresión programados.
GetJob (Required) Devuelve parámetros de trabajo.
SetJob (Required) Cancela, pausa, reanuda o reinicia un trabajo de impresión o establece parámetros de trabajo.

Funciones de administración de formularios

Function Description
AddForm Agrega un formulario especificado a la lista de los disponibles para una impresora especificada.
DeleteForm Quita un formulario especificado de la lista de los disponibles para una impresora especificada.
EnumForms Devuelve una lista de formularios disponibles para una impresora especificada.
GetForm Devuelve las características de un formulario especificado.
SetForm Modifica las características de un formulario especificado.
Function Description
AddPrintProcessor Instala un procesador de impresión en el servidor especificado y lo agrega a la lista de aquellos a los que puede llamar el proveedor de impresión.
DeletePrintProcessor Elimina un procesador de impresión de la lista de aquellos a los que puede llamar el proveedor de impresión.
EnumPrintProcessorDataTypes Devuelve una lista de los tipos de datos admitidos por los procesadores de impresión a los que el proveedor de impresión puede llamar.
EnumPrintProcessors Devuelve la lista de procesadores de impresión a los que puede llamar el proveedor de impresión.
GetPrintProcessorDirectory Devuelve la ruta de acceso del directorio en la que se deben almacenar los archivos del procesador de impresión.
Function Description
AddMonitor Agrega un monitor de impresión a la lista de los que el proveedor de impresión puede llamar.
DeleteMonitor Elimina un monitor de impresión de la lista de aquellos a los que puede llamar el proveedor de impresión.
EnumMonitors Devuelve la lista de monitores de impresión a los que puede llamar el proveedor de impresión.

Funciones de administración de puertos

Function Description
AddPort Adds a printer port to the list of those available, typically by calling the specified port monitor's AddPortUI function.
AddPortEx(/previous-versions/ff545025(v%3dvs.85)) Same as AddPort, with additional parameters.
ConfigurePort (Required) Configures a printer port, typically by calling the specified port monitor's ConfigurePortUI function.
DeletePort (Required) Deletes a printer port from the list of those available, typically by calling the specified port monitor's DeletePortUI function.
EnumPorts (Required) Devuelve una lista de puertos de impresora disponibles.
SetPort Establece parámetros para un puerto de impresora especificado.

Funciones de administración del Registro

Function Description
DeletePrinterData Deletes the value currently assigned to a specified value name, under the specified printer's PrinterDriverData key.
DeletePrinterDataEx Same as DeletePrinterData, with additional parameters.
DeletePrinterKey Deletes a specified key and its subkeys, if they are currently stored in the registry under the specified printer's PrinterDriverData key.
EnumPrinterData Returns each of the value names and currently assigned values that are stored in the registry under the specified printer's PrinterDriverData key.
EnumPrinterDataEx Same as EnumPrinterData, with additional parameters.
EnumPrinterKey Devuelve una lista de subclaves que se encuentran actualmente en el Registro bajo un nombre de clave especificado.
GetPrinterData Returns the value currently assigned to a specified value name, which is stored in the registry under the specified printer's PrinterDriverData key.
GetPrinterDataEx Same as GetPrinterData, with additional parameters.
SetPrinterData Stores a specified value name and value in the registry, under the specified printer's PrinterDriverData key.
SetPrinterDataEx Same as SetPrinterData, with additional parameters.

Other functions

Function Description
XcvData Proporciona una ruta de comunicación entre un archivo DLL de interfaz de usuario del monitor de puerto y un archivo DLL del servidor de supervisión de puertos.
  • Last updated on