Section INF DDInstall
Chaque section DDInstall DDInstall contient une directive DriverVer facultative et une ou plusieurs directives référençant des sections nommées supplémentaires dans le fichier INF, illustrées ici avec les directives INF les plus fréquemment spécifiées, CopyFiles et AddReg, répertoriées en premier.
Les sections référencées par ces directives contiennent des instructions pour installer des fichiers de pilote et écrire des informations spécifiques à l’appareil et/ou spécifiques au pilote dans le Registre.
[install-section-name] |
[install-section-name.nt] |
[install-section-name.ntx86] |
[install-section-name.ntia64] | (Windows XP and later versions of Windows)
[install-section-name.ntamd64] | (Windows XP and later versions of Windows)
[install-section-name.ntarm] | (Windows 8 and later versions of Windows)
[install-section-name.ntarm64] (Windows 10 version 1709 and later versions of Windows)
[DriverVer=mm/dd/yyyy[,x.y.v.z]]
[CopyFiles=@filename | file-list-section[,file-list-section] ...]
[CopyINF=filename1.inf[,filename2.inf]...] (Windows XP and later versions of Windows)
[AddReg=add-registry-section[,add-registry-section]...]
[AddProperty=add-property-section[,add-property-section]...] (Windows Vista and later versions of Windows)
[Include=filename1.inf[,filename2.inf]...]
[Needs=inf-section-name[,inf-section-name]...]
[Delfiles=file-list-section[,file-list-section]...]
[Renfiles=file-list-section[,file-list-section]...]
[DelReg=del-registry-section[,del-registry-section]...]
[DelProperty=del-property-section[,del-property-section]...] (Windows Vista and later versions of Windows)
[FeatureScore=featurescore]... (Windows Vista and later versions of Windows)
[BitReg=bit-registry-section[,bit-registry-section]...]
[LogConfig=log-config-section[,log-config-section]...]
[ProfileItems=profile-items-section[,profile-items-section]...] (Windows 2000 and later versions of Windows)
[UpdateInis=update-ini-section[,update-ini-section]...]
[UpdateIniFields=update-inifields-section[,update-inifields-section]...]
[Ini2Reg=ini-to-registry-section[,ini-to-registry-section]...]
[RegisterDlls=register-dll-section[,register-dll-section]...]
[UnregisterDlls=unregister-dll-section[,unregister-dll-section]...]
[ExcludeID=device-identification-string[,device-identification-string]...]... ((Windows XP and later versions of Windows)
[Reboot]
Entrées
Toutes les entrées valides ne sont pas prises en charge dans unINF universel
Pris en charge dans un INF universel
DriverVer=mm/jj/aaaa[,x.y.v.z]
Cette entrée facultative spécifie les informations de version du package de pilotes .
Pour plus d’informations sur la façon de spécifier cette entrée, consultez directive INF DriverVer.
CopyFiles=@nom de fichier | file-list-section[,file-list-section] ...
Cette directive spécifie un fichier nommé à copier à partir du support source vers la destination ou référence une ou plusieurs sections définies par l’enregistreur INF dans lesquelles les fichiers pertinents pour l’appareil sur le support source sont spécifiés pour le transfert vers la destination. La directive CopyFiles est facultative, mais présente dans la plupart des sections DDInstall.
L’entrée DefaultDestDir dans la section DestinationDirs de l’INF spécifie la destination de tout fichier unique à copier. Les SourceDisksNames et sections SourceDisksFiles, ou un inf supplémentaire spécifié dans l’entrée LayoutFile de cette section Version, indiquez l’emplacement sur le support de distribution des fichiers du pilote.
Pour plus d’informations, consultez directive Inf CopyFiles.
CopyINF=filename1.inf[,filename2.inf]...
(Windows XP et versions ultérieures) Cette directive entraîne la copie des fichiers INF spécifiés dans le système cible.
Pour plus d’informations, consultez directive INF CopyINF.
AddReg=add-registry-section[,add-registry-section]...
Cette directive fait référence à une ou plusieurs sections définies par l’enregistreur INF dans lesquelles de nouvelles sous-clés, éventuellement avec des entrées de valeur initiales, sont spécifiées pour être écrites dans le Registre ou dans lesquelles les entrées de valeur des clés existantes sont modifiées.
Une spécification HKR dans une telle section de registre de compléments désigne la « clé logicielle » chemin d’accès au registre de l’appareil en cours d’installation.
Pour plus d’informations, consultez directive AddReg INF.
AddProperty=add-property-section[,add-property-section]...
(Windows Vista et versions ultérieures) Fait référence à une ou plusieurs sections de fichier INF qui modifient propriétés de l’appareil définies pour une instance d’appareil. Vous devez utiliser une directive INF AddProperty uniquement pour définir une propriété d’instance d’appareil qui est nouvelle pour Windows Vista ou les versions ultérieures des systèmes d’exploitation Windows.
Pour les propriétés d’instance d’appareil introduites précédemment sur Windows Server 2003, Windows XP ou Windows 2000 et qui ont des valeurs d’entrée de Registre correspondantes, vous devez continuer à utiliser directives Inf AddReg pour définir les propriétés de l’instance d’appareil. Ces instructions s’appliquent aux propriétés définies par le système et aux propriétés personnalisées. Pour plus d’informations sur l’utilisation de la directive AddProperty, consultez Using the INF AddProperty Directive and the INF DelProperty Directive.
Include=filename1.inf[,filename2.inf]...
Cette entrée facultative spécifie un ou plusieurs fichiers INF fournis par le système qui contiennent des sections nécessaires à l’installation de cet appareil et/ou du pilote. Si cette entrée est spécifiée, il s’agit généralement d’une entrée Besoins.
Par exemple, les fichiers INF pour les pilotes de périphérique qui dépendent de la prise en charge du streaming du noyau du système peuvent spécifier cette entrée comme suit :
Include= ks.inf, kscaptur.inf, ksfilter.inf
Needs=inf-section-name[,inf-section-name]...
Cette entrée facultative spécifie des sections dans les fichiers INF fournis par le système qui doivent être traités pendant l’installation de cet appareil. En règle générale, une telle section nommée est une section DDInstall (ou DDInstall.xxx) dans l’un des fichiers INF répertoriés dans une entrée Inclure. Toutefois, il peut s’agir de n’importe quelle section référencée dans un tel DDInstall ou DDInstall.section xxx de l’INF inclus.
Par exemple, les fichiers INF pour les pilotes de périphérique qui ont l’entrée Inclure peuvent spécifier cette entrée comme suit :
Needs= KS.Registration, KSCAPTUR.Registration.NT, MSPCLOCK.Installation
FeatureScore=featurescore
Avertissement
La directive FeatureScore est traitée uniquement lorsqu’elle est spécifiée directement dans la section [DDInstall].
(Windows Vista et versions ultérieures) Cette directive fournit un critère de classement supplémentaire pour les pilotes basés sur les fonctionnalités prises en charge par un pilote. Par exemple, les scores de fonctionnalités peuvent être définis pour une classe de configuration d’appareil qui distingue les pilotes en fonction de critères spécifiques à la classe.
Pour plus d’informations sur le classement des pilotes, consultez How Windows Rank Drivers (Windows Vista and Later).
Pour plus d’informations sur cette directive, consultez directive FeatureScore INF.
Note
Bien qu’une section
ExcludeID=device-identification-string[,device-identification-string]...
Avertissement
La directive ExcludeID est traitée uniquement lorsqu’elle est spécifiée directement dans la section [DDInstall].
(Windows XP et versions ultérieures) Cette directive spécifie une ou plusieurs chaînes d’identification d’appareil (ID matériels ou ID compatibles). La section DDInstall n’installe pas les appareils qui ont ID d’appareil qui correspondent à l’un des ID matériels ou aux ID compatibles répertoriés.
redémarrage
Cette directive indique que l’appelant doit être invité à redémarrer le système une fois l’installation terminée.
Pour plus d’informations, consultez directive de redémarrage INF.
Non pris en charge dans un INF universel
Delfiles=file-list-section[,file-list-section]...
Cette directive fait référence à une ou plusieurs sections définies par l’enregistreur INF qui répertorient les fichiers sur la cible à supprimer.
Pour plus d’informations, consultez directive INF DelFiles.
Renfiles=file-list-section[,file-list-section]...
Cette directive fait référence à une ou plusieurs sections définies par l’enregistreur INF qui répertorient les fichiers à renommer sur la destination avant que les fichiers sources pertinents sur l’appareil soient copiés sur l’ordinateur cible.
Pour plus d’informations, consultez directive RenFiles INF.
DelReg=del-registry-section[,del-registry-section]...
Cette directive fait référence à une ou plusieurs sections définies par l’enregistreur INF dans lesquelles les clés et/ou les entrées de valeur sont spécifiées pour être supprimées du Registre pendant l’installation des appareils.
En règle générale, cette directive est utilisée pour gérer les mises à niveau lorsqu’un INF doit nettoyer les anciennes entrées de Registre d’une installation précédente de cet appareil.
Une spécification HKR dans une telle section delete-registry désigne la « clé logicielle » chemin d’accès au registre de l’appareil en cours d’installation.
Pour plus d’informations, consultez directive DelReg INF.
DelProperty=del-property-section[,del-property-section]...
(Windows Vista et versions ultérieures) Fait référence à une ou plusieurs sections de fichier INF qui suppriment propriétés d’appareil définies pour une instance d’appareil. Vous devez utiliser une directive INF DelProperty uniquement pour supprimer une propriété d’instance d’appareil qui est nouvelle pour Windows Vista ou les versions ultérieures de Windows.
Pour les propriétés d’instance d’appareil introduites précédemment sur Windows Server 2003, Windows XP ou Windows 2000 et qui ont des valeurs d’entrée de Registre correspondantes, vous devez continuer à utiliser directives DelReg INF pour supprimer les propriétés de l’instance d’appareil. Ces instructions s’appliquent aux propriétés définies par le système et aux propriétés personnalisées. Pour plus d’informations sur l’utilisation de la directive DelProperty, consultez Using the INF AddProperty Directive and the INF DelProperty Directive.
BitReg=bit-registry-section[,bit-registry-section]...
Cette directive fait référence à une ou plusieurs sections définies par l’enregistreur INF dans lesquelles les entrées de valeur de Registre existantes de type REG_BINARY sont modifiées.
Une spécification HKR dans une telle section de registre de bits désigne la « clé logicielle » chemin d’accès au registre de l’appareil en cours d’installation.
Pour plus d’informations, consultez directive BitReg INF.
LogConfig=log-config-section[,log-config-section]...
Cette directive fait référence à une ou plusieurs sections définies par l’enregistreur INF dans un INF pour un appareil énuméré racine ou pour un appareil installé manuellement. Dans ces sections nommées, l’inf pour un appareil « détecté » ou installé manuellement spécifie une ou plusieurs configurations logiques de ressources matérielles relatives au bus que l’appareil doit être opérationnel. L’inf pour un appareil installé manuellement qui n’est pas configurable par logiciel doit également avoir un DDInstall. Section factDef.
La directive LogConfig n’est jamais utilisée pour installer des appareils Plug-and-Play (PnP). Toutefois, vous pouvez utiliser une section INF DDInstall.LogConfigOverride pour fournir une configuration de remplacement pour les appareils PnP.
Cette directive n’est pas pertinente pour tous les pilotes et composants de niveau supérieur (nondevice).
Pour plus d’informations, consultez directive LogConfig INF.
ProfileItems=profile-items-section[,profile-items-section]...
(Microsoft Windows 2000 et versions ultérieures de Windows) Cette directive rarement utilisée fait référence à une ou plusieurs sections définies par l’enregistreur INF qui décrivent les éléments à ajouter ou supprimés du menu Démarrer.
Pour plus d’informations, consultez directive INF ProfileItems.
UpdateInis=update-ini-section[,update-ini-section]...
Cette directive rarement utilisée fait référence à une ou plusieurs sections définies par l’enregistreur INF, en spécifiant un fichier INI source à partir duquel une section ou une ligne particulière dans une telle section doit être lue dans un fichier INI de destination du même nom pendant l’installation. Si vous le souhaitez, les modifications de ligne par ligne apportées à un fichier INI existant sur la destination à partir d’un fichier INI source donné du même nom peuvent être spécifiées dans la section update-ini.
Pour plus d’informations, consultez directive INF UpdateInis.
UpdateIniFields=update-inifields-section[,update-inifields-section]...
Cette directive rarement utilisée fait référence à une ou plusieurs sections définies par l’enregistreur INF dans lesquelles les modifications dans les lignes d’un fichier INI spécifique à l’appareil sont spécifiées.
Pour plus d’informations, consultez directive INF UpdateIniFields.
Ini2Reg=ini-to-registry-section[,ini-to-registry-section]...
Cette directive rarement utilisée fait référence à une ou plusieurs sections définies par l’enregistreur INF dans lesquelles les sections ou lignes d’un fichier INI spécifique à l’appareil, fournies sur le support source, doivent être déplacées dans le Registre.
Pour plus d’informations, consultez directive INF Ini2Reg.
RegisterDlls=register-dll-section[,register-dll-section]...
Cette directive fait référence à une ou plusieurs sections INF utilisées pour spécifier des fichiers qui sont des contrôles OLE et qui nécessitent l’autoinscription.
Pour plus d’informations, consultez directive RegisterDlls INF.
UnregisterDlls=unregister-dll-section[,unregister-dll-section]...
Cette directive fait référence à une ou plusieurs sections INF utilisées pour spécifier des fichiers qui sont des contrôles OLE et qui nécessitent une désinscription automatique (auto-suppression).
Pour plus d’informations, consultez directive inf unregisterDlls.
Remarques
Dans la documentation du Kit de pilotes Windows (WDK), le terme DDInstall est utilisé pour faire référence à un de nom de section d’installation, avec ou sans extensions de plateforme. Par conséquent, «section DDInstall » signifie « une section nommée dans un INF, ayant le format [install-section-name] ou [install-section-name.ntxxx] ». Lorsque vous créez des noms pour sections DDInstall, vous devez inclure un préfixe spécifique à l’appareil, tel que [WDMPNPB003_Device] ou [GPR400. Install.NT].
Chaque
À l’exception des appareils qui n’ont aucun fichier associé à transférer à partir du support source, un fichier INF qui installe un pilote WDM sur différentes plateformes de système d’exploitation doit avoir au moins l’une des sections suivantes DDInstall :
- Une section install-section-name.ntx86 section qui spécifie les entrées des installations de périphérique/pilote spécifiques aux plateformes x86.
- Une section install-section-name.ntia64 qui spécifie les entrées pour les installations de périphérique/pilote spécifiques aux plateformes Itanium.
- Une section install-section-name.ntamd64 qui spécifie les entrées des installations de périphérique/pilote spécifiques aux plateformes x64.
- Une section install-section-name.ntarm qui spécifie les entrées des installations de périphérique/pilote spécifiques aux plateformes arm.
- Un nom de section d’installation .ntarm64 section qui spécifie les entrées des installations de périphérique/pilote spécifiques aux plateformes arm64.
- Une section install-section-name ou install-section-name.nt qui spécifie les entrées pour les installations de périphérique/pilote qui ne sont pas spécifiques à une plateforme matérielle particulière.
Pour plus d’informations sur l’utilisation du.nt
À compter de Windows 2000, un fichier INF qui installe les pilotes doit avoir sections DDInstall.Services pour spécifier les informations du service de pilote.
Chaque directive d’une section DDInstall peut référencer plusieurs noms de section. Toutefois, chaque section nommée supplémentaire doit être séparée de la suivante avec une virgule (,).
Chaque nom de section doit être unique dans le fichier INF et doit respecter les règles générales de définition des noms de section. Pour plus d’informations sur ces règles, consultez Règles de syntaxe générales pour les fichiers INF.
Toute directive AddReg
En fonction de la classe de configuration d’appareil
- Génération d’un fichier INF pour un d’appareil Windows SideShow-Compatible
- section DDInstall dans un fichier INF réseau
- fichiers INF pour les appareils toujours image
- fichiers INF pour les appareils WIA
- Configuration requise pour l’installation de pour les composants réseau
- spécification de directives WDF dans les fichiers INF
Exemples
Cet exemple montre l’expansion des sections DDInstall, Ser_Inst et Inp_Inst. Ces sections sont référencées dans l’exemple de la section INF Models.
[Ser_Inst]
CopyFiles=Ser_CopyFiles, mouclass_CopyFiles
[Ser_CopyFiles]
sermouse.sys
[mouclass_CopyFiles] ; section name referenced by > 1 CopyFiles
mouclass.sys
[Inp_Inst]
CopyFiles=Inp_CopyFiles, mouclass_CopyFiles
[Inp_CopyFiles]
inport.sys
L’exemple suivant montre la section DDInstall d’un fichier INF qui installe un pilote WDM fourni par le système pour un périphérique audio sur différentes plateformes de système d’exploitation :
[WDMPNPB003_Device.NT]
Include=ks.inf, wdmaudio.inf
Needs=KS.Registration, WDMAUDIO.Registration.NT
CopyFiles=MSSB16.CopyList
AddReg=WDM_SB16.AddReg
L’exemple suivant montre les sections référencées par l’entrée besoins
[KS.Registration]
; following AddReg= is actually a single line in the ks.inf file
AddReg=ProxyRegistration,CategoryRegistration,\
TopologyNodeRegistration,PlugInRegistration,PinNameRegistration,\
DeviceRegistration
CopyFiles=KSProxy.Files,KSDriver.Files
[WDMAUDIO.Registration.NT]
AddReg=WDM.AddReg
CopyFiles=WDM.CopyFiles.Sys, WDM.CopyFiles.Drv
;
; INF-writer-defined add-registry and file-list sections
; referenced by preceding directives are omitted here for brevity
;