Section INF DefaultInstall
Notes
Si vous créez un package de pilotes universel, cette section est valide uniquement s’il a une décoration d’architecture, par exemple [DefaultInstall.NTAMD64].
Notes
L’utilisation des sections DefaultInstall et Manufacturer dans votre INF entraîne des échecs de validation INF universels et peut entraîner des comportements d’installation incohérents. Consultez Utilisation d’un fichier INF universel.
La section DefaultInstall d’un fichier INF est accessible si un utilisateur sélectionne l’élément de menu « Installer » après avoir sélectionné et enfoncé (ou cliqué avec le bouton droit) sur le nom du fichier INF. Sur Windows 10 version 1903 et versions ultérieures de Windows, un INF avec DefaultInstall peut être utilisé dans de nombreuses API de package de pilotes s’il répond aux exigences d’un pilote primitif.
[DefaultInstall] |
[DefaultInstall.nt] |
[DefaultInstall.ntx86] |
[DefaultInstall.ntia64] | (Windows XP and later versions of Windows)
[DefaultInstall.ntamd64] | (Windows XP and later versions of Windows)
[DefaultInstall.ntarm] | (Windows 8 and later versions of Windows)
[DefaultInstall.ntarm64] (Windows 10 version 1709 and later versions of Windows)
[CopyFiles=@filename | file-list-section[,file-list-section] ...]
[CopyINF=filename1.inf[,filename2.inf]...]
[AddReg=add-registry-section[,add-registry-section]...]
[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]...]
[BitReg=bit-registry-section[,bit-registry-section]...]
[ProfileItems=profile-items-section[,profile-items-section]...]
[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]...] ...
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
CopyFiles=@filename | file-list-section[,file-list-section] ...
Cette directive facultative spécifie un fichier nommé à copier à partir du support source vers la destination, ou fait référence à une ou plusieurs sections définies par l’enregistreur INF qui spécifient les fichiers à transférer du média source vers la destination.
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 de Windows.) 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.
Pour plus d’informations, consultez Directive AddReg INF.
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 système 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 spécifient 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 spécifient cette entrée comme suit :
Needs= KS.Registration,KSCAPTUR.Registration.NT,MSPCLOCK.Installation
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.
Pour plus d’informations, consultez Directive DelReg INF.
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. Pour plus d’informations, consultez Directive AddReg INF.
Pour plus d’informations, consultez Directive BitReg INF.
ProfileItems=profile-items-section[,profile-items-section]...
Cette directive 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 spécifié 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
Les sections DefaultInstall ne doivent pas être utilisées pour les installations d’appareils. Utilisez les sections DefaultInstall uniquement pour l’installation de pilotes de filtre de classe, de filtres de système de fichiers et de services de pilotes de noyau qui ne sont pas associés à un nœud d’appareil (devnode).
Si vous utilisez DefaultInstall sur Windows 10 version 1903 et versions ultérieures de Windows, il est recommandé que le fichier INF réponde aux exigences d’un pilote primitif.
Notes
Le fichier INF d’un package de pilotes qui a une section Fabricant ne doit pas contenir de section INF DefaultInstall si le package de pilotes doit être signé numériquement. Pour plus d’informations sur la signature de packages de pilotes, consultez Signature de pilotes.
Notes
Contrairement à une section DDInstall , une section DefaultInstall ne peut pas contenir de directives DriverVer ou LogConfig .
Pour installer une section DefaultInstall à partir d’une application d’installation d’appareil, utilisez l’appel suivant à InstallHinfSection :
InstallHinfSection(NULL,NULL,TEXT("DefaultInstall 132 path-to-inf\infname.inf"),0);
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.
Exemples
L’exemple suivant montre une section DefaultInstall classique :
[DefaultInstall]
CopyFiles=MyAppWinFiles, MyAppSysFiles, @SRSutil.exe
AddReg=MyAppRegEntries