Entrées de fichier INF d’imprimante

Article
03/08/2023

Important

Nous vous recommandons d’utiliser le pilote de classe de boîte de réception IPP 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 d’appareils d’imprimante.

Pour plus d’informations, consultez le guide de conception d’application de prise en charge de l’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 comme entrée, et la fonction AddPrinter nécessite une structure PRINTER_INFO_2 en tant qu’entrée. Le programme d’installation par défaut de la classe d’imprimante Windows 2000 ou version ultérieure, Ntprint.dll, lit les fichiers INF de l’imprimante pour obtenir des valeurs de chaîne qui doivent être placées dans ces structures avant que les fonctions soient appelées.

Un ensemble d’entrées de fichier INF pour les pilotes d’imprimante que Ntprint.dll reconnaît a été défini. Ces entrées ont le format suivant :

EntryName = Valeur

où EntryName est une chaîne identifiant l’entrée et Value est une valeur de chaîne affecté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 comprend les éléments suivants :

Valeur qui doit être affectée à l’entrée.
Valeur par défaut que Ntprint.dll utilise si l’entrée n’est pas définie.
Membre de structure dans lequel Ntprint.dll place un pointeur vers la valeur d’entrée.

Entrée de fichier INF	Valeur	Valeur par défaut (si l’entrée n’est pas spécifiée)	Membre de structure
ConfigFile	Nom de la DLL de l’interface d’imprimante du pilote.	Valeur spécifiée pour DriverFile.	pConfigFile, membre de la structure DRIVER_INFO_3
DataFile	Nom du fichier de données associé d’un pilote, tel qu’un fichier PPD.	Nom de section du pilote dans le fichier INF.	pDataFile, membre de la structure DRIVER_INFO_3
DefaultDataType	Non utilisé avec les systèmes d’exploitation basés sur NT.
DriverCategory	Consultez la note 1, à la suite de ce tableau.	Si le fichier INF ne spécifie pas de catégorie de pilote (comme la plupart des pilotes v3), on suppose que la catégorie du pilote est PrintFax.Printer.	None
DriverFile	Nom de la DLL graphique d’imprimante du pilote.	Nom de section du pilote dans le fichier INF.	pDriverPath, membre de la structure DRIVER_INFO_3
ExcludeFromSelect	Consultez la note 2, qui suit ce tableau.	None	None
HelpFile	Nom du fichier d’aide de la DLL d’interface.	Aucun. Aucun fichier d’aide n’est spécifié.	pHelpFile, membre de la structure DRIVER_INFO_3
LanguageMonitor	Nom d’un moniteur de langue à associer au pilote d’imprimante. Consultez la section LanguageMonitor Value Format .	Aucun. Un moniteur de langue n’est pas spécifié.	pMonitorName, membre de la structure DRIVER_INFO_3
PrintProcessor	Nom d’un processeur d’impression à associer à la file d’attente d’imprimantes. Consultez la section PrintProcessor Value Format .	Le processeur d’impression par défaut (WinPrint) est utilisé.	pPrintProcessor, membre de la structure DRIVER_INFO_2
VendorSetup	Nom d’une fonction dans une DLL fournie par le fournisseur, qui gère les opérations de configuration d’imprimante personnalisées.	Aucun. Consultez la note 3, à la suite de ce tableau.	None
InboxVersionRequiredred	Version minimale acceptable pour tous les pilotes principaux référencés par inf. Pour plus d’informations sur InboxVersionRequired, consultez directive INF InboxVersionRequired.	None	None

1 (DriverCategory) : si le fichier INF spécifie une catégorie, il s’agit des valeurs autorisées (0 à 5 respectivement) pour spécifier des catégories :

Catégorie de pilotes	Valeur	Description
PrintFax.Printer	0	File d’attente d’impression qui représente une imprimante connectée à l’ordinateur (via un protocole local ou réseau), ou 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	File d’attente d’impression qui représente une machine de télécopie physique ou virtuelle. Lorsque l’utilisateur imprime sur une imprimante de télécopie, le résultat (éventuellement après une interaction supplémentaire de l’utilisateur) est qu’une télécopie est envoyée.
PrintFax.Printer.File	2	File d’attente d’impression qui génère des documents de copie réversible. Lorsque l’utilisateur imprime sur une imprimante de fichiers, l’utilisateur doit d’abord entrer un nom de fichier, puis le spouleur envoie la sortie imprimée à ce fichier. Les imprimantes de fichiers nécessitent toujours un nom de fichier, mais n’acceptent aucune autre entrée utilisateur. Lorsqu’il n’existe aucune option permettant à l’utilisateur de fournir un nom de fichier, l’application génère un nom de fichier qui est mis à la disposition du spouleur. Parmi les exemples courants d’imprimantes de fichiers, citons microsoft XPS Document Writer (MXDW) et les enregistreurs PDF.
PrintFax.Printer.Virtual	3	File d’attente d’impression avec un pilote qui effectue une opération sur les données imprimées opaque pour le spouleur d’impression. Lorsque l’utilisateur imprime sur une imprimante virtuelle, certains résultats possibles incluent le document imprimé enregistré quelque part sur l’ordinateur, envoyé à une autre application ou envoyé par courrier électronique. Un exemple courant d’impression sur une imprimante virtuelle est le scénario 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 Imprimantes virtuelles dans les fichiers INF d’imprimante.
PrintFax.Printer.Service	4	File d’attente d’impression qui représente un service d’impression. Lorsque l’utilisateur choisit d’imprimer dans un service, le résultat (éventuellement après une interaction supplémentaire de l’utilisateur) est qu’un service d’impression tiers reçoit le contenu imprimé. L’utilisateur peut ensuite se rendre à l’emplacement physique de l’entreprise pour récupérer la sortie imprimée.
PrintFax.Printer.3D	5	File d’attente d’impression qui représente le flux de données d’une imprimante 3D. Si cette catégorie est spécifiée involontairement pour une imprimante 2D (imprimante standard), l’imprimante 2D génère simplement le contenu 2D du flux de données. Si cette catégorie est correctement spécifiée pour une imprimante 3D, mais qu’un flux de données 2D est envoyé à l’imprimante 3D, l’imprimante 3D ne génère aucune sortie.

Notez également que les pilotes d’impression v4 utilisent un fichier manifeste. Pour plus d’informations, consultez Manifeste du pilote V4.

Notes

2 (ExclureFromSelect) : ID d’appareil d’un appareil qui ne doit pas être affiché dans la boîte de dialogue Sélectionner un appareil ou dans l’Assistant Ajouter une imprimante. Pour les imprimantes, cela inclut toutes les entrées PnP des appareils 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 de cette table, doit apparaître dans la section Indicateurs de contrôle du fichier INF. Pour plus d’informations, consultez la section Inf ControlFlags .

Notes

3 (VendorSetup) : si aucune entrée VendorSetup n’est spécifiée, les opérations d’installation personnalisées ne sont pas effectuées. En particulier, aucune interface utilisateur n’est autorisée lors de l’installation du processeur d’impression, du moniteur d’impression ou du pilote d’imprimante, sauf via l’utilisation de l’entrée INF VendorSetup. Pour plus d’informations sur cette entrée, consultez Opérations de configuration d’imprimante personnalisées.

Important

VendorSetup est désormais déconseillé 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 de fichier INF d’imprimante sont généralement spécifiées dans les sections de données du fichier INF de l’imprimante. Pour obtenir des exemples, consultez Exemples de fichiers INF d’imprimante.

Format de valeur LanguageMonitor

Lorsqu’une entrée LanguageMonitor est incluse dans un fichier INF d’imprimante, le format de valeur est le suivant :

LanguageMonitor= » MonitorName , MonitorDLLName »

où MonitorName est une chaîne de texte représentant le nom affiché du moniteur et MonitorDLLName est le nom de fichier de la DLL du moniteur.

Format de valeur PrintProcessor

Lorsqu’une entrée PrintProcessor est incluse dans un fichier INF d’imprimante, le format de valeur est le suivant :

PrintProcessor= » PrintProcessorName , PrintProcessorDLLName »

où PrintProcessorName est une chaîne de texte représentant le nom affiché du processeur d’impression et PrintProcessorDLLName est le nom de fichier de la DLL.

Fichiers dépendants

Pour Windows 2000 et versions ultérieures, un fichier dépendant est un fichier de pilote d’imprimante inclus dans une section d’installation du fichier INF d’imprimante avec un dirid de 66000, mais pas affecté 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 (autrement dit, 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 Installation de composants de pilotes personnalisés et schéma de communication bidirectionnel.

Les opérations de point et d’impression installent à la fois le pilote et les fichiers dépendants du pilote sur le client.

Un maximum de 64 fichiers dépendants peuvent être spécifiés pour chaque modèle d’imprimante.

Schéma de communication bidirectionnel

INF ControlFlags Section

Installation de composants de pilotes personnalisés

Pointer et imprimer

Section d’installation du fichier INF de l’imprimante

Manifeste du pilote V4