Section INF DDInstall.HW
DDInstall. Les sections HW sont généralement utilisées pour installer des périphériques multifonctions, pour installer des pilotes de filtre PnP et pour configurer des informations spécifiques aux appareils accessibles à l’utilisateur, mais indépendantes des pilotes dans le Registre, que ce soit avec des directives AddReg explicites ou avec des entrées Include et Needs .
[install-section-name.HW] |
[install-section-name.nt.HW] |
[install-section-name.ntx86.HW] |
[install-section-name.ntia64.HW] | (Windows XP and later versions of Windows)
[install-section-name.ntamd64.HW] | (Windows XP and later versions of Windows)
[install-section-name.ntarm.HW] | (Windows 8 and later versions of Windows)
[install-section-name.ntarm64.HW] (Windows 10 version 1709 and later versions of Windows)
[AddReg=add-registry-section[,add-registry-section]...] ...
[Include=filename.inf[,filename2.inf]...]
[Needs=inf-section-name[,inf-section-name]...]
[DelReg=del-registry-section[,del-registry-section]...] ...
[BitReg=bit-registry-section[,bit-registry-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
AddReg=add-registry-section[,add-registry-section]...
Référence un ou plusieurs add-registry-sections inf-writer-defined ailleurs dans le fichier INF pour les appareils couverts par ce DDInstall. Section HW . La section add-registry installe généralement des filtres et/ou stocke des informations par appareil dans le registre. Une spécification HKR d’une telle section add-registry spécifie la clé matérielle de l’appareil, une sous-clé de Registre spécifique à l’appareil qui contient des informations sur l’appareil. Une clé matérielle est également appelée clé d’appareil. Pour plus d’informations, consultez Arborescences et clés du Registre pour les périphériques et les pilotes. Un package de pilotes peut ajouter des paramètres via un INF à l’aide d’une spécification HKR dans une section de registre supplémentaire référencée par une section DDInstall.HW.
Pour plus d’informations, consultez Directive AddReg INF.
Include=filename. inf[,filename2.inf]...
Spécifie un ou plusieurs fichiers INF supplémentaires fournis par le système qui contiennent les sections nécessaires pour installer cet appareil. Si cette entrée est spécifiée, il en est généralement de même pour une entrée Needs .
Needs=inf-section-name[,inf-section-name]...
Spécifie les sections nommées 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. Section HW dans un fichier INF fourni par le système qui est répertorié dans une entrée Include . Toutefois, il peut s’agir de n’importe quelle section référencée dans un tel DDInstall. Section HW du fichier INF inclus.
Non pris en charge dans un inf universel
DelReg=del-registry-section[,del-registry-section]...
Référence un ou plusieurs fichiers inf-writer-defined delete-registry-sectionailleurs dans le fichier INF pour les pilotes des appareils couverts par cette section DDInstall . Une telle section delete-registry supprime les informations de registre obsolètes d’un périphérique/pilote installé précédemment de l’ordinateur cible. Une spécification HKR dans une telle section delete-registry désigne la même sous-clé que pour AddReg.
Cette directive est rarement utilisée, sauf dans un fichier INF qui met à niveau une installation précédente des mêmes appareils/modèles répertoriés dans la section par fabricant par modèle qui a défini le nom de cette section DDInstall . Pour plus d’informations, consultez Directive DelReg INF.
BitReg=bit-registry-section[,bit-registry-section] ...
Est valide dans cette section, mais n’est presque jamais utilisé. Une spécification HKR dans une section de registre de bits référencée désigne la même sous-clé que pour AddReg. Pour plus d’informations, consultez Directive BitReg INF.
Remarques
Les extensions qui ne respectent pas la casse du nom de section d’installation indiquée dans l’instruction de syntaxe formelle peuvent être insérées dans un tel DDInstall. Nom de la section HW dans les fichiers INF multiplateformes. 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.
N’importe quel DDInstall. La section HW doit avoir l’un des éléments suivants :
- Directive AddReg .
- Entrée Include qui spécifie un autre fichier INF. Dans ce cas, DDInstall. La section HW doit également contenir une entrée Needs correspondante qui spécifie une section dans l’autre fichier INF. Cette section est utilisée pour configurer les informations de Registre nécessaires.
Chaque directive dans un DDInstall. La section HW peut référencer plusieurs sections définies par un enregistreur INF. 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.
Pour plus d’informations sur l’installation d’appareils multifonctions, consultez Prise en charge des appareils multifonctions.
Exemples
Cet exemple montre comment un package de pilotes peut utiliser DDInstall. Sections HW et DDInstall. Services sections pour ajouter à la fois un pilote de fonction et un pilote de filtre supérieur PnP.
[Example_DDInstall]
CopyFiles=example_copyfiles
[Example_DDInstall.HW]
AddReg=filter_addreg
[filter_addreg]
HKR,,"UpperFilters",0x00010000,"ExampleUpperFilter" ; [REG_MULTI_SZ](https://learn.microsoft.com/windows/desktop/SysInfo/registry-value-types) value
[Example_DDInstall.Services]
AddService=ExampleFunctionDriver,0x00000002,function_ServiceInstallSection
AddService=ExampleUpperFilter,,filter_ServiceInstallSection
[function_ServiceInstallSection]
DisplayName = %function_ServiceDesc%
ServiceType = 1
StartType = 3
ErrorControl = 1
ServiceBinary = %13%\ExampleFunctionDriver.sys
[filter_ServiceInstallSection]
DisplayName = %filter_ServiceDesc%
ServiceType = 1
StartType = 3
ErrorControl = 1
ServiceBinary = %13%\ExampleUpperFilter.sys