Partager via

Fonctions définies par les fournisseurs d’impression

Warning

À compter de Windows 10, les API qui prennent en charge les fournisseurs d’impression tiers sont déconseillées. Microsoft ne recommande aucun investissement dans des fournisseurs d’impression tiers. En outre, sur windows 8 et les produits plus récents où le modèle de pilote d’impression v4 est disponible, les fournisseurs d’impression tiers peuvent ne pas créer ou gérer des files d’attente qui utilisent des pilotes d’impression v4.

Cette rubrique répertorie toutes les fonctions qu’un fournisseur d’impression peut fournir. La plupart de ces fonctions sont décrites dans la documentation du Kit de développement logiciel (SDK) Microsoft Windows. Si la fonction est décrite dans le Kit de pilotes Windows (WDK), le nom de la fonction fournit un lien vers la page de référence associée.

Tous les fournisseurs d’impression doivent fournir des pointeurs pour toutes les fonctions répertoriées. Toutefois, la plupart des fournisseurs d’impression fournis par le fournisseur sont des « fournisseurs partiels » qui n’ont pas besoin de prendre en charge de nombreuses opérations définies par les fonctions. Therefore, many of the function pointers can be NULL. Pour plus d’informations sur les fournisseurs d’impression partiels, consultez Écriture d’un fournisseur d’impression réseau.

Dans les listes de fonctions suivantes, les fonctions qui doivent être prises en charge sont étiquetées « Obligatoire ».

All print providers must export the initialization function, InitializePrintProvidor. Pointers to all the other functions must be supplied in a PRINTPROVIDOR structure. (Notez que ces deux noms sont mal orthographiés, mais sont cohérents avec les noms qui apparaissent dans le fichier d’en-tête, Winsplp.h.)

Les fonctions sont divisées en groupes et présentées dans les sections suivantes :

  • Initialization function

  • Fonctions de gestion des files d’attente d’impression

  • Fonctions de gestion des pilotes d’imprimante

  • Fonctions de création de travaux d’impression

  • Imprimer les fonctions de planification des travaux

  • Fonctions de gestion des formulaires

  • Fonctions de gestion des processeurs d’impression

  • Fonctions de gestion des moniteurs d’impression

  • Fonctions de gestion des ports

  • Fonctions de gestion du Registre

  • Other functions

Initialization function

Function Description
InitializePrintProvidor (Required) Initialise le fournisseur d’impression et retourne des pointeurs vers des fonctions fournies.
Function Description
AddPrinter Ajoute une file d’attente d’impression à la liste des fichiers gérés par le fournisseur d’impression et associe un processeur d’impression à la file d’attente d’impression.
AddPrinterConnection Crée une connexion à la file d’attente d’impression spécifiée.
ClosePrinter (Required) Désactive l’accès de l’appelant à une file d’attente d’impression spécifiée.
DeletePrinter Supprime une file d’attente d’impression de la liste des fichiers gérés par le fournisseur d’impression.
DeletePrinterConnection Supprime une connexion à la file d’attente d’impression spécifiée.
EnumPrinters (Required) Énumère les files d’attente d’impression actuellement gérées par le fournisseur d’impression.
FindClosePrinterChangeNotification Disables printer change notifications that were enabled by FindFirstPrinterChangeNotification.
FindFirstPrinterChangeNotification Retourne un handle à un objet d’attente que l’appelant peut utiliser pour attendre les événements d’imprimante spécifiés.
GetPrinter (Required) Retourne les valeurs de paramètre actuelles pour une file d’attente d’impression spécifiée.
OpenPrinter (Required) Permet à l’appelant d’accéder à une file d’attente d’impression spécifiée.
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) Définit les paramètres d’une file d’attente d’impression spécifiée.
WaitForPrinterChange Obsolete.

Fonctions de gestion des pilotes d’imprimante

Function Description
AddPrinterDriver Ajoute les fichiers de pilote d’une imprimante spécifiée à un serveur spécifié.
AddPrinterDriverEx Same as AddPrinterDriver, with additional parameters.
DeletePrinterDriver Supprime l’accès aux fichiers de pilote d’une imprimante spécifiée, sur un serveur spécifié.
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. (Les informations retournées sont généralement obtenues à partir d’un fichier INF.)
[GetPrinterDriverEx Same as GetPrinterDriver, with additional parameters.
GetPrinterDriverDirectory Retourne le nom du répertoire du pilote d’imprimante du serveur.
Function Description
AbortPrinter (Required) Tente de supprimer le travail actuel de la file d’attente d’impression spécifiée.
AddJob (Required) Retourne un identificateur de travail et un chemin de fichier depool. The caller uses CreateFile and WriteFile to send data to the spool file.
EndDocPrinter (Required) Effectue les opérations d’achèvement des travaux.
EndPagePrinter Effectue des opérations d’achèvement de page.
ReadPrinter Obtient les informations d’état d’une imprimante bidirectionnelle.
ScheduleJob (Required) Informe le fournisseur qu’un travail spécifié peut être planifié. The job is specified by a job identifier previously returned by AddJob.
StartDocPrinter (Required) Prépare le fournisseur d’impression pour commencer lepooling d’un travail d’impression.
StartPagePrinter Prépare le fournisseur d’impression pour recevoir une page de travail d’impression.
WritePrinter (Required) Reçoit une partie du flux de données du travail d’impression.

Note

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

Function Description
EnumJobs (Required) Retourne une liste de travaux d’impression planifiés.
GetJob (Required) Retourne les paramètres du travail.
SetJob (Required) Annule, suspend, reprend ou redémarre un travail d’impression ou définit des paramètres de travail.

Fonctions de gestion des formulaires

Function Description
AddForm Ajoute un formulaire spécifié à la liste des formulaires disponibles pour une imprimante spécifiée.
DeleteForm Supprime un formulaire spécifié de la liste des formulaires disponibles pour une imprimante spécifiée.
EnumForms Retourne la liste des formulaires disponibles pour une imprimante spécifiée.
GetForm Retourne les caractéristiques d’un formulaire spécifié.
SetForm Modifie les caractéristiques d’un formulaire spécifié.
Function Description
AddPrintProcessor Installe un processeur d’impression sur le serveur spécifié et l’ajoute à la liste de ceux que le fournisseur d’impression peut appeler.
DeletePrintProcessor Supprime un processeur d’impression de la liste de ceux que le fournisseur d’impression peut appeler.
EnumPrintProcessorDataTypes Retourne une liste des types de données pris en charge par les processeurs d’impression qui sont appelants par le fournisseur d’impression.
EnumPrintProcessors Retourne la liste des processeurs d’impression que le fournisseur d’impression peut appeler.
GetPrintProcessorDirectory Retourne le chemin d’accès au répertoire dans lequel les fichiers processeur d’impression doivent être stockés.
Function Description
AddMonitor Ajoute un moniteur d’impression à la liste de ceux que le fournisseur d’impression peut appeler.
DeleteMonitor Supprime un moniteur d’impression de la liste de ceux que le fournisseur d’impression peut appeler.
EnumMonitors Retourne la liste des moniteurs d’impression que le fournisseur d’impression peut appeler.

Fonctions de gestion des ports

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) Retourne la liste des ports d’imprimante disponibles.
SetPort Définit les paramètres d’un port d’imprimante spécifié.

Fonctions de gestion du Registre

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 Retourne une liste de sous-clés actuellement contenues dans le Registre sous un nom de clé spécifié.
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 Fournit un chemin de communication entre une DLL d’interface utilisateur du moniteur de port et une DLL de serveur de surveillance de port.
  • Last updated on