Section Version INF

  • Article

Par convention, la section Version apparaît en premier dans les fichiers INF. Chaque fichier INF doit avoir cette section.

[Version]
 
Signature="signature-name"
[Class=class-name]
[ClassGuid={nnnnnnnn-nnnn-nnnn-nnnn-nnnnnnnnnnnn}]
[Provider=%INF-creator%]
[ExtensionId={xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}]
[LayoutFile=filename.inf [,filename.inf]... ]  (Windows 2000 and Windows XP)
[CatalogFile=filename.cat]
[CatalogFile.nt=unique-filename.cat]
[CatalogFile.ntx86=unique-filename.cat]
[CatalogFile.ntia64=unique-filename.cat]  (Windows XP and later versions of Windows)
[CatalogFile.ntamd64=unique-filename.cat]  (Windows XP and later versions of Windows)
[CatalogFile.ntarm=unique-filename.cat]  (Windows 8 and later versions of Windows)
[CatalogFile.ntarm64=unique-filename.cat]  (Windows 10 version 1709 and later versions of Windows)

DriverVer=mm/dd/yyyy,w.x.y.z
[PnpLockDown=0|1] (Windows Vista and later versions of Windows)
[DriverPackageDisplayName=%driver-package-description%]
[DriverPackageType=PackageType]

Entrées

Signature="signature-name »
Doit être $Windows NT$ ou $Chicago$. Cela indique les systèmes d’exploitation pour lesquels cet INF est valide. Ces valeurs de signature ont les significations suivantes.

Valeur de la signature Signification
$Windows NT$ Tous les systèmes d’exploitation Windows
$Chicago$ Tous les systèmes d’exploitation Windows

Les caractères de signe dollar englobant ($) sont obligatoires, mais ces chaînes ne respectent pas la casse. Si signature-name n’est aucune de ces valeurs de chaîne, le fichier n’est pas accepté comme un INF valide.

En règle générale, Windows ne fait pas de distinction entre ces valeurs de signature. L’un d’entre eux doit être spécifié, mais peu importe lequel. Vous devez spécifier la valeur appropriée afin qu’une personne lisant un fichier INF puisse déterminer les systèmes d’exploitation pour lesquels il est destiné.

Certains programmes d’installation de classe mettent des exigences supplémentaires sur la façon dont la valeur de signature doit être spécifiée. Ces exigences, si elles existent, sont décrites dans les sections spécifiques au type d’appareil de ce Kit de pilotes Windows (WDK).

Un INF doit fournir des informations d’installation spécifiques au système d’exploitation en ajoutant des extensions définies par le système à ses sections DDInstall , que le nom de la signature soit $Windows NT$ ou $Chicago$. (Pour plus d’informations sur ces extensions, consultez Création de fichiers INF pour plusieurs plateformes et systèmes d’exploitation .)

Class=class-name
Pour tout type d’appareil standard, spécifie le nom de la classe d’installation de l’appareil pour le type d’appareil installé à l’aide de ce fichier INF. Ce nom est généralement l’un des noms de classe définis par le système, tels que Net ou Display, qui sont répertoriés dans Devguid.h. Pour plus d’informations, consultez Classes d’installation d’appareil fournies par le système.

Si un INF spécifie une classe, il doit également spécifier la valeur GUID définie par le système correspondant pour son entrée ClassGUID . La spécification de la valeur GUID correspondante pour un appareil de n’importe quelle classe de configuration de périphérique prédéfinie peut installer l’appareil et ses pilotes plus rapidement, car cela aide le code de configuration du système à optimiser sa recherche INF.

Si un INF ajoute une nouvelle classe d’appareils d’installation au système, il doit fournir une valeur unique , ne respectant pas la casse, qui diffère de l’une des classes fournies par le système dans Devguid.h. La longueur de la chaîne class-name doit comporter 32 caractères ou moins. L’INF doit spécifier une valeur GUID nouvellement générée pour l’entrée ClassGUID . Consultez également la section INF ClassInstall32.

Cette entrée n’est pas pertinente pour un INF qui n’installe ni un nouveau pilote de périphérique sous une classe d’installation de périphérique prédéfinie, ni une nouvelle classe d’installation de périphérique.

Notes

Cette entrée est requise pour les pilotes de périphérique installés via le gestionnaire Plug-and-Play (PnP).

ClassGuid={nnnnnnnn-nnnn-nnnn-nnnn nnnn-nnnnnnnnnn}
Spécifie le GUID de la classe d’installation d’appareil . La valeur GUID est mise en forme comme indiqué ici, où chaque n est un chiffre hexadécimal.

Cette valeur GUID spécifie la classe d’installation d’appareil à affecter aux appareils installés à partir de ce fichier INF. Cette valeur GUID spécifique à la classe identifie également le programme d’installation de la classe d’appareil pour le type d’appareil et le fournisseur de page de propriétés spécifique à la classe, le cas échéant.

Pour une nouvelle classe d’installation d’appareil, l’INF doit spécifier une valeur ClassGUID nouvellement générée. Pour plus d’informations sur la création de GUID, consultez Utilisation de GUID dans les pilotes. Consultez également Classes d’installation de l’appareil.

Notes

Cette entrée est requise pour les pilotes de périphérique installés via le gestionnaire PnP.

ExtensionId={xxxxxxxx-xxxx-xxxx-xxxxxxxxxxxx}
Spécifie le GUID de l’ID d’extension lors de la création d’une extension INF. La valeur GUID est mise en forme comme indiqué ici, où chaque x est un chiffre hexadécimal.

Lors de la création de la version initiale d’un INF d’extension, l’INF doit spécifier une valeur ExtensionId nouvellement générée. Toutefois, lors de la mise à jour d’une extension INF existante, l’ExtensionId doit rester le même afin que plusieurs versions associées de l’INF d’extension soient mises à jour les unes par rapport aux autres au lieu d’être traitées comme des INF d’extension indépendantes qui peuvent être installées simultanément sur le même appareil instance. Pour plus d’informations sur la création d’extensions INF, consultez Utilisation d’un fichier INF d’extension.

Notes

Cette entrée est requise uniquement lors de la création d’une extension INF, comme identifié en spécifiant Class = Extension et ClassGuid = {e2f84ce7-8efa-411c-aa69-97454ca4cb57}.

ClassVer=major.Mineur
Réservé à une utilisation système, sauf si une classe d’appareil telle qu’Imprimante l’exige explicitement. Par exemple, consultez INF du pilote V4.

Provider=%INF-creator%
Identifie le fournisseur du fichier INF. En règle générale, ce jeton est spécifié sous la forme d’un % jeton OrganizationName% qui est développé ultérieurement dans la section Chaînes du fichier INF. La longueur maximale, en caractères, d’un nom de fournisseur est LINE_LEN.

Par exemple, les fichiers INF fournis avec le système spécifient généralement le créateur INF comme %Msft% et définissent %Msft% = « Microsoft » dans leurs sections Strings .

Notes

Cette entrée est requise pour les pilotes de périphérique installés via le gestionnaire PnP.

CatalogFile=filename.cat
Spécifie un catalogue (.fichier cat) à inclure sur le support de distribution d’un package de pilotes.

Lorsqu’un package de pilotes est soumis à Microsoft pour la signature numérique, WHQL fournit un fichier catalogue pour le package de pilotes après que WHQL a testé et affecté des signatures numériques au package. Pour plus d’informations sur le test et la signature des packages de pilotes IHV ou OEM, consultez Signature de publication WHQL. Les fichiers catalogue ne sont pas répertoriés dans la section SourceDisksFiles ou la directive CopyFiles de l’INF. Windows suppose que le fichier catalogue se trouve au même emplacement que le fichier INF.

Les fichiers INF fournis par le système n’ont jamais d’entrées CatalogFile= , car le système d’exploitation valide la signature d’un tel INF par rapport à tous les fichiers xxx.cat fournis par le système.

CatalogFile.nt=unique-filename.cat |
CatalogFile.ntx86=unique-filename.cat |
CatalogFile.ntia64=unique-filename.cat |
CatalogFile.ntamd64=unique-filename.cat
CatalogFile.ntarm=unique-filename.cat
CatalogFile.ntarm64=unique-filename.cat

Spécifie un autre nom de fichier unique déterminé par INF-writer, avec . extension cat , d’un fichier catalogue. Si ces entrées facultatives sont omises, un CatalogFile=filename.cat donné est utilisé pour valider les installations de périphériques/pilotes WDM.

Si un CatalogFile décoré.L’entrée xxx = existe dans la section Version d’un INF avec une entrée CatalogFile= non décorée. L’entrée non décorée est supposée identifier un filename.cat pour valider les installations de périphériques, les installations de pilotes ou les deux sur les plateformes pour lesquelles aucune entrée décorée n’est spécifiée.

Tout fichier INF de pilote de périphérique multiplateforme contenant CatalogFile= et CatalogFile.les entrées xxx= doivent fournir un nom unique déterminé par IHV/OEM pour chaque fichier .cat.

Pour plus d’informations sur l’utilisation des extensions .nt, .ntx86, .ntia64, .ntamd64, .ntarm et .ntarm64 définies par le système, consultez Création de fichiers INF pour plusieurs plateformes et systèmes d’exploitation.

Notes

Étant donné que le même fichier .cat peut être utilisé sur toutes les plateformes prises en charge, l’utilisation de cette entrée n’est pas obligatoire ou recommandée. Toutefois, vous devez utiliser cette entrée si vous souhaitez créer des fichiers .cat spécifiques à la plateforme pour votre package de pilotes.

DriverVer=mm/jj/aaaa,w.x.y.z
Cette entrée spécifie des informations de version pour les pilotes installés par ce fichier INF. À compter de Windows 2000, cette entrée est obligatoire.

Pour plus d’informations sur la façon de spécifier cette entrée, consultez La directive INF DriverVer.

PnpLockDown=0|1
Spécifie si Plug-and-Play (PnP) empêche les applications de modifier directement les fichiers spécifiés par le fichier INF d’un package de pilotes. Si la directive PnpLockDown est définie sur 1, PnP empêche les applications de modifier directement les fichiers copiés par les directives Inf CopyFiles . Sinon, si la directive n’est pas incluse dans un fichier INF ou si la valeur de la directive est définie sur zéro, une application disposant de privilèges d’administrateur peut modifier directement ces fichiers. Les fichiers de pilotes protégés de cette manière sont appelés fichiers de pilotes protégés par des tiers.

Pour garantir l’intégrité d’une installation de pilote PnP, les applications ne doivent pas modifier directement les fichiers de pilotes copiés par le fichier INF du package de pilotes. Les applications doivent uniquement utiliser les mécanismes d’installation des appareils fournis par Windows pour mettre à jour les pilotes PnP.

À compter de Windows Vista, un package de pilotes doit définir PnpLockDown sur 1 pour empêcher une application de modifier directement les fichiers de pilotes. Toutefois, certaines applications existantes qui désinstallent les packages de pilotes suppriment directement les fichiers de pilotes. Pour maintenir la compatibilité avec ces applications, la directive PnpLockDown pour ce package de pilotes doit être définie sur zéro.

Notes

Bien que PnP sur Windows Vista et les versions ultérieures de Windows ne nécessite pas qu’un fichier INF contienne une directive PnpLockDown pour installer un pilote, PnP dans une version ultérieure de Windows peut exiger que les fichiers INF pour les packages de pilotes PnP incluent la directive PnpLockDown .

DriverPackageDisplayName=%driver-package-description%
Action déconseillée. Était précédemment utilisé par les frameworks d’installation de pilotes (DIFx). Pour plus d’informations sur la dépréciation de DIFx, consultez recommandations DIFx.

DriverPackageType=PackageType
Action déconseillée. Était précédemment utilisé par les frameworks d’installation de pilotes (DIFx). Pour plus d’informations sur la dépréciation de DIFx, consultez recommandations DIFx.

Remarques

Lorsqu’un package de pilotes réussit le test WHQL (Hardware Quality Lab) Microsoft Windows, WHQL retourne les fichiers catalogue .cat à IHV ou OEM. Chaque fichier .cat contient une signature chiffrée numériquement pour le package de pilotes. IHV ou OEM doit répertorier ces fichiers .cat dans la section Version INF et doit fournir les fichiers sur le support de distribution, au même emplacement que le fichier INF. Les fichiers .cat doivent être décompressés.

Notes

Si une section Version INF n’inclut pas au moins une entrée CatalogFile ou CatalogFile.ntxxx , le pilote est traité comme non signé et les dates répertoriées dans la directive DriverVer ne sont pas affichées par Windows.

Pour plus d’informations, consultez Signature de pilote.

Exemples

L’exemple suivant montre une section Version typique d’un fichier INF de package de pilotes simple, suivie des sections SourceDisksNames et SourceDisksFiles requises impliquées par les entrées spécifiées dans cet exemple de section Version :

[Version]
Signature="$Windows NT$"
Class=SCSIAdapter
ClassGUID={4D36E97B-E325-11CE-BFC1-08002BE10318}
Provider=%INF_Provider%
CatalogFile=example.cat
DriverVer=01/29/2010,1.2.3.4
PnpLockdown=1

[SourceDisksNames]
;
; diskid = description[, [tagfile] [, <unused>, subdir]]
;
1 = %Disk_Description%,,,\WinNT

[SourceDisksFiles.x86]
;
; filename_on_source = diskID[, [subdir][, size]]
;
exampleDriver.sys = 1,\x86

; ...

[Strings]
INF_Provider="Contoso"
Disk_Description = "Contoso Drivers Disk"
; ...

Voir aussi

DDInstall

SourceDisksNames

SourceDisksFiles

Chaînes