Section INF DDInstall

Article
06/15/2023

Chaque section DDInstall par modèle 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 l’installation des fichiers de pilotes et l’écriture d’informations spécifiques au périphérique et/ou 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 un INF universel. La liste suivante répertorie les directives qui sont valides dans un INF universel et celles qui ne le sont pas.

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 pour le package de pilotes.

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

CopyFiles=@filename | file-list-section[,file-list-section] ...
Cette directive spécifie un fichier nommé à copier à partir du média source vers la destination ou fait référence à une ou plusieurs sections définies par inf-writer 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 elle est présente dans la plupart des sections DDInstall .

L’entrée DefaultDestDir de la section DestinationDirs de l’INF spécifie la destination de tout fichier unique à copier. Les sections SourceDisksNames et SourceDisksFiles , ou un inf supplémentaire spécifié dans l’entrée LayoutFile de la section Version de cet INF, fournissent l’emplacement sur le support de distribution des fichiers de pilote.

Pour plus d’informations, consultez Directive CopyFiles INF.

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 CopyINF INF.

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 d’une telle section de registre de compléments désigne le chemin d’accès de registre « clé logicielle » 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) Référence une ou plusieurs sections de fichier INF qui modifient les propriétés d’appareil définies pour un instance d’appareil. Vous devez utiliser une directive Inf AddProperty uniquement pour définir une propriété de 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 de 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 les directives AddReg INF pour définir les propriétés de 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 Utilisation de la directive AddProperty INF et de la directive INF DelProperty.

Include=filename1.inf[,filename2.inf]...
Cette entrée facultative spécifie un ou plusieurs fichiers INF supplémentaires fournis par le système qui contiennent les sections nécessaires pour installer cet appareil et/ou ce pilote. Si cette entrée est spécifiée, il en est généralement de même pour une entrée Needs .

Par exemple, les fichiers INF pour les pilotes de périphérique qui dépendent de la prise en charge de la diffusion en continu 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 les sections dans les fichiers INF fournis par le système qui doivent être traitées pendant l’installation de cet appareil. En règle générale, une telle section nommée est un DDInstall (ou DDInstall).xxx) section dans l’un des fichiers INF répertoriés dans une entrée Include . Toutefois, il peut s’agir de n’importe quelle section référencée dans un tel DDInstall ou DDInstall.xxx section du inf inclus.

Par exemple, les fichiers INF pour les pilotes de périphérique qui ont l’entrée Include précédente 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, des scores de fonctionnalités peuvent être définis pour une classe de configuration d’appareil qui fait la distinction entre les pilotes en fonction de critères spécifiques à la classe.

Pour plus d’informations sur le classement des pilotes, consultez Comment Windows classe les pilotes (Windows Vista et versions ultérieures).

Pour plus d’informations sur cette directive, consultez Directive FeatureScore INF.

Notes

Bien qu’une section DDInstall puisse contenir plusieurs entrées FeatureScore , seule la première entrée est traitée pour la 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 dont les ID d’appareil 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 un enregistreur INF répertoriant 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 répertoriant les fichiers à renommer sur la destination avant que les fichiers sources pertinents pour l’appareil ne 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 des clés et/ou des 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 propre d’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 le chemin d’accès de registre « clé logicielle » 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 les propriétés d’appareil définies pour un instance d’appareil. Vous devez utiliser une directive Inf DelProperty uniquement pour supprimer une propriété d’appareil instance qui est nouvelle pour Windows Vista ou les versions ultérieures de Windows.

Pour les propriétés instance d’appareil qui ont été 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 les directives Inf DelReg pour supprimer les propriétés de 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 Utilisation de la directive Inf AddProperty et de la directive INF DelProperty.

BitReg=bit-registry-section[,bit-registry-section]...
Cette directive fait référence à une ou plusieurs sections définies par un 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 le chemin du Registre « clé logicielle » 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 au sein d’un INF pour un appareil énuméré à la racine ou pour un appareil installé manuellement. Dans ces sections nommées, l’INF d’un appareil « détecté » ou installé manuellement spécifie une ou plusieurs configurations logiques des ressources matérielles relatives au bus que l’appareil doit être opérationnel. L’INF d’un tel 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 (non-appareil).

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 à supprimer dans le menu Démarrer.

Pour plus d’informations, consultez Inf ProfileItems Directive.

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 au sein d’une telle section doit être lue dans un fichier INI de destination du même nom lors de l’installation. Si vous le souhaitez, les modifications ligne par ligne d’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, fourni sur le média 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 une inscription automatique.

Pour plus d’informations, consultez Directive Inf RegisterDlls.

UnregisterDlls=unregister-dll-section[,unregister-dll-section]...
Cette directive fait référence à une ou plusieurs sections INF utilisées pour spécifier les fichiers qui sont des contrôles OLE et qui nécessitent une désinscription automatique (suppression automatique).

Pour plus d’informations, consultez Directive INF UnregisterDlls.

Remarques

Dans la documentation du Kit de pilotes Windows (WDK), le terme DDInstall est utilisé pour désigner un nom de section d’installation, avec ou sans extensions de plateforme. Par conséquent, « section DDInstall » signifie « section nommée au sein d’un INF, au format [install-section-name] ou [install-section-name.ntxxx] ». Lorsque vous créez des noms pour les sections DDInstall , vous devez inclure un préfixe spécifique à l’appareil, tel que [WDMPNPB003_Device] ou [GPR400. Install.NT].

Chaque section DDInstall doit être référencée dans une entrée spécifique à l’appareil/aux modèles sous la section Modèles INF par fabricant du fichier INF.

À l’exception des appareils qui n’ont aucun fichier associé à transférer à partir du média source, un fichier INF qui installe un pilote WDM sur différentes plateformes de système d’exploitation doit avoir au moins une des sections DDInstall suivantes :

Une section install-section-name.ntx86 qui spécifie les entrées pour les installations de périphériques/pilotes spécifiques aux plateformes x86.
Section install-name.ntia64 qui spécifie les entrées pour les installations de périphériques/pilotes spécifiques aux plateformes Itanium.
Section install-name.ntamd64 qui spécifie les entrées pour les installations de périphériques/pilotes spécifiques aux plateformes x64.
Section install-section-name.ntarm qui spécifie les entrées pour les installations de périphériques/pilotes spécifiques aux plateformes Arm.
Section install-name.ntarm64 qui spécifie les entrées pour les installations de périphériques/pilotes 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ériques/pilotes qui ne sont pas spécifiques à une plateforme matérielle particulière.

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.

À compter de Windows 2000, un fichier INF qui installe des pilotes doit avoir des sections DDInstall.Services pour spécifier les informations de service du 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 par une virgule (,).

Chaque nom de section doit être unique dans le fichier INF et doit suivre 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 spécifiée dans une section DDInstall est supposée référencer une section de registre d’ajouts qui ne peut pas être utilisée pour stocker des informations sur les pilotes de filtre supérieur ou inférieur, sur les périphériques multifonctions ou sur les paramètres indépendants des pilotes, mais spécifiques à l’appareil. Si un périphérique/pilote INF doit stocker ce type d’informations dans le Registre, il doit utiliser une directive AddReg dans son DDInstall non décoré et non décoré. Sections HW, le cas échéant, pour référencer une autre section add-registry-section définie par INF-writer.

Selon la classe d’installation de l’appareil spécifiée dans la section INF Version, des directives supplémentaires spécifiques à la classe peuvent être spécifiées dans une section DDInstall . Pour plus d’informations sur les directives spécifiques à une classe, consultez les rubriques suivantes :

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 Modèles INF.

[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 précédente dans les fichiers ks.inf et wdmaudio.inf fournis par le système. Dans l’exemple précédent, ces fichiers sont spécifiés dans l’entrée Includes . Lorsque le programme d’installation de l’appareil du système d’exploitation traite le nom de section d’installation de cet appareil. nt section, ces deux sections suivantes sont également traitées.

[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
;