Entrées des fichiers INF d’imprimante
Important
La plateforme d’impression moderne est le moyen privilégié de Windows pour communiquer avec les imprimantes. Nous vous recommandons d’utiliser le pilote de classe IPP en boîte de Microsoft, ainsi que les applications de support d’impression (PSA), pour personnaliser l’expérience d’impression dans Windows 10 et 11 pour le développement de périphériques d’impression.
Pour plus d’informations, veuillez consulter la section Plateforme d’impression moderne et le Guide de conception des applications de support d’impression.
Pour qu’une application d’installation installe une imprimante sur un serveur d’impression, elle doit appeler la fonction AddPrinterDriverEx du spouleur pour charger les fichiers de pilote, puis appeler la fonction AddPrinter du spouleur pour rendre l’imprimante disponible sur le serveur.
La fonction AddPrinterDriverEx nécessite une structure DRIVER_INFO_3 en entrée, et la fonction AddPrinter nécessite une structure PRINTER_INFO_2 en entrée. Le programme d’installation de classe d’imprimante par défaut, Ntprint.dll, lit les fichiers INF d’imprimante pour obtenir les valeurs de chaînes qui doivent être placées dans ces structures avant l’appel des fonctions.
Un ensemble d’entrées de fichiers INF pour les pilotes d’imprimante que Ntprint.dll reconnaît a été défini. Ces entrées ont le format suivant :
NomDeLentrée = Valeur
Où NomDeLentrée est une chaîne identifiant l’entrée et Valeur est une chaîne de caractères assignée à l’entrée.
Le tableau suivant répertorie les entrées de fichier INF qui doivent être incluses dans les fichiers INF d’imprimante. Pour chaque entrée, le tableau inclut les éléments suivants :
La valeur qui doit être assignée à l’entrée.
La valeur par défaut que Ntprint.dll utilise si l’entrée n’est pas définie.
Le membre de la structure dans lequel Ntprint.dll place un pointeur vers la valeur de l’entrée.
| Entrée de fichier INF | Valeur | Valeur par défaut (si l’entrée n’est pas spécifiée) | Membre de la structure |
|---|---|---|---|
| ConfigFile | Le nom de la DLL d’interface de l’imprimante du pilote. | Valeur spécifiée pour DriverFile. | Membre pConfigFile de la structure DRIVER_INFO_3 |
| DataFile | Le nom d’un fichier de données associé au pilote, tel qu’un fichier PPD. | Nom de la section du pilote dans le fichier INF. | Membre pDataFile de la structure DRIVER_INFO_3 |
| DefaultDataType | Non utilisé avec les systèmes d’exploitation basés sur NT. | ||
| DriverCategory | Veuillez consulter la Note 1 après ce tableau. | Si le fichier INF ne spécifie pas de catégorie de pilote (comme la plupart des pilotes v3), on suppose alors que la catégorie du pilote est PrintFax.Printer. | Aucune |
| DriverFile | Le nom de la DLL de graphiques d’imprimante du pilote. | Nom de la section du pilote dans le fichier INF. | Membre pDriverPath de la structure DRIVER_INFO_3 |
| ExcludeFromSelect | Veuillez consulter la Note 2 après ce tableau. | None | None |
| HelpFile | Le nom du fichier d’aide de la DLL d’interface. | Aucune. Un fichier d’aide n’est pas spécifié. | Membre pHelpFile de la structure DRIVER_INFO_3 |
| LanguageMonitor | Le nom d’un moniteur de langue à associer au pilote d’imprimante. Veuillez consulter la section Format de la valeur de LanguageMonitor. | Aucune. Un moniteur de langue n’est pas spécifié. | Membre pMonitorName de la structure DRIVER_INFO_3 |
| PrintProcessor | Le nom d’un processeur d’impression à associer à la file d’attente d’impression. Veuillez consulter la section Format de la valeur de PrintProcessor. | Le processeur d’impression par défaut (WinPrint) est utilisé. | Membre pPrintProcessor de la structure DRIVER_INFO_2 |
| VendorSetup | Le nom d’une fonction dans une DLL fournie par le fournisseur, qui gère les opérations de configuration d’imprimante personnalisée. | Aucune. Veuillez consulter la Note 3 après ce tableau. | Aucune |
| InboxVersionRequired | La version minimale acceptable pour tous les pilotes principaux auxquels se réfère le fichier INF. Pour plus d’informations sur InboxVersionRequired, veuillez consulter la directive INF InboxVersionRequired. | None | None |
1 (DriverCategory) : Si le fichier INF spécifie une catégorie, voici les valeurs autorisées (de 0 à 5 respectivement) pour spécifier les catégories :
| Catégorie de pilote | Valeur | Description |
|---|---|---|
| PrintFax.Printer | 0 | Une file d’attente d’impression représentant soit une imprimante connectée à l’ordinateur (par un protocole local ou réseau), soit un proxy vers une imprimante physique sur un autre ordinateur. Lorsque l’utilisateur imprime sur une imprimante physique, le résultat est du papier avec le document imprimé dessus. |
| PrintFax.Fax | 1 | Une file d’attente d’impression représentant une machine de télécopie physique ou virtuelle. Lorsque l’utilisateur imprime sur une imprimante de télécopie, le résultat (après une éventuelle interaction utilisateur supplémentaire) est qu’une télécopie est envoyée. |
| PrintFax.Printer.File | 2 | Une file d’attente d’impression générant des documents numériques. Lorsque l’utilisateur imprime sur une imprimante de fichier, il doit d’abord saisir un nom de fichier, puis le spouleur envoie la sortie imprimée à ce fichier. Les imprimantes de fichier nécessitent toujours un nom de fichier mais ne demandent aucune autre entrée de l’utilisateur. Quand il n’y a pas d’option pour l’utilisateur de fournir un nom de fichier, l’application génère un nom de fichier qui est mis à disposition du spouleur. Exemples courants d’imprimantes de fichier : Microsoft XPS Document Writer (MXDW) et les writers PDF. |
| PrintFax.Printer.Virtual | 3 | Une file d’attente d’impression ayant un pilote qui effectue une opération sur les données imprimées, opaque pour le spouleur d’impression. Quand l’utilisateur imprime sur une imprimante virtuelle, les résultats possibles incluent la sauvegarde du document imprimé sur l’ordinateur, l’envoi à une autre application ou l’envoi par e-mail. Un exemple courant d’impression sur une imprimante virtuelle est la situation où le document imprimé est envoyé à l’imprimante Microsoft Office OneNote. Lorsque l’utilisateur choisit d’imprimer sur une imprimante virtuelle, une interaction utilisateur supplémentaire peut être nécessaire, initiée par le pilote ou un autre composant du pilote. Pour plus d’informations, consultez la section Imprimantes virtuelles dans les fichiers INF d’imprimante. |
| PrintFax.Printer.Service | 4 | Une file d’attente d’impression représentant un service d’impression. Quand l’utilisateur choisit d’imprimer vers un service, le résultat (après une éventuelle interaction utilisateur) est que le contenu imprimé est envoyé à un service d’impression tiers. L’utilisateur peut ensuite se rendre sur le site physique de l’entreprise pour récupérer le document imprimé. |
| PrintFax.Printer.3D | 5 | Une file d’attente d’impression représentant le flux de données pour une imprimante 3D. Si cette catégorie est spécifiée par erreur pour une imprimante 2D (imprimante classique), l’imprimante 2D produira simplement le contenu 2D du flux de données. Si cette catégorie est spécifiquement désignée pour une imprimante 3D, mais qu’un flux de données 2D est envoyé à l’imprimante 3D, cette dernière ne produira aucune sortie. |
Notez également que les pilotes d’impression v4 utilisent un fichier Manifest. Pour plus d’informations, consultez le Manifeste du pilote v4.
Remarque
2 (ExcludeFromSelect) : L’ID du périphérique d’un appareil qui ne doit pas être affiché dans la boîte de dialogue Sélectionner un périphérique ou dans l’assistant Ajouter une imprimante. Pour les imprimantes, cela inclut toutes les entrées PnP des périphériques qui ont des descriptions d’appareil en double dans le fichier INF ; par exemple, les appareils qui ont plusieurs entrées pour l’énumération infrarouge et parallèle ou pour un autre bus. L’entrée ExcludeFromSelect, contrairement à toutes les autres dans ce tableau, doit apparaître dans la section Flags de contrôle du fichier INF. Pour plus d’informations, consultez la section Section ControlFlags de l’INF.
Remarque
3 (VendorSetup) : Si aucune entrée VendorSetup n’est spécifiée, les opérations de configuration personnalisée ne sont pas effectuées. En particulier, aucune interface utilisateur n’est permise lors de l’installation du processeur d’impression, du moniteur d’impression ou du pilote d’imprimante, sauf à travers l’entrée VendorSetup du fichier INF. Pour plus d’informations sur cette entrée, consultez la rubrique Opérations de configuration d’imprimante personnalisée.
Important
VendorSetup est désormais obsolète et ne doit pas être utilisé par les nouveaux pilotes v3 ou v4 que vous développez. Ces informations sur VendorSetup sont fournies à titre de référence uniquement, ou pour la maintenance des pilotes v3 existants qui utilisent déjà cette directive INF.
Les entrées des fichiers INF d’imprimante sont généralement spécifiées dans les sections de données de fichiers INF d’imprimante. Pour des exemples, consultez les Exemples de fichiers INF d’imprimante.
Format de la valeur de LanguageMonitor
Lorsqu’une entrée LanguageMonitor est incluse dans un fichier INF d’imprimante, le format de la valeur est le suivant :
LanguageMonitor=" MonitorName , MonitorDLLName "
Où NomDuMoniteur est une chaîne de texte représentant le nom affiché du moniteur, et NomDLLDuMoniteur est le nom de fichier de la DLL du moniteur.
Format de la valeur de PrintProcessor
Lorsqu’une entrée PrintProcessor est incluse dans un fichier INF d’imprimante, le format de la valeur est le suivant :
PrintProcessor=" PrintProcessorName , PrintProcessorDLLName "
Où NomDuPrintProcessor est une chaîne de texte représentant le nom affiché du processeur d’impression, et NomDLLDuPrintProcessor est le nom de fichier de la DLL.
Fichiers dépendants
Un fichier dépendant est un fichier de pilote d’imprimante qui est inclus dans une section d’installation de fichier INF d’imprimante avec un dirid de 66000, mais qui n’est pas assigné aux entrées DriverFile, DataFile, ConfigFile ou HelpFile.
L’exemple suivant montre des extraits d’un fichier INF qui installe trois fichiers dépendants en les copiant dans le répertoire du pilote d’imprimante (c’est-à-dire dans le répertoire spécifié par dirid 66000) :
[Contoso]
%PRINTER_MODEL_123%=Contoso_Install_Section,LPTENUM\Contoso_1284.4_P29C5
...
[Contoso_Install_Section]
CopyFiles=@Contoso.ini,@Contoso.xml,@Contoso.dll
...
[DestinationDirs]
DefaultDestDir=66000
...
[Strings]
PRINTER_MODEL_123 = "Contoso Printer Model 123"
Dans cet exemple, Contoso.ini est un fichier INI d’imprimante, Contoso.xml est un fichier d’extension bidi et Contoso.dll est un composant personnalisé. Pour plus d’informations sur les fichiers INI d’imprimante, les fichiers d’extension bidi et les composants personnalisés, consultez les rubriques Installation de composants de pilote personnalisés et Schéma de communication bidirectionnelle.
Point-and-print installe à la fois le pilote et les fichiers dépendants du pilote sur le client.
Un maximum de 64 fichiers dépendants peut être spécifié pour chaque modèle d’imprimante.
Articles connexes
Schéma de communication bidirectionnelle
Installation de composants de pilote personnalisés