Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
DDInstall. Les sections HW sont généralement utilisées pour l’installation d’appareils à fonctions multiples, pour l’installation de pilotes de filtre PnP et pour la configuration d’informations spécifiques à l’appareil accessible par 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 Besoins .
[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. Les listes suivantes indiquent quelles directives sont valides dans un INF universel et qui ne le sont pas.
Pris en charge dans un INF universel
AddReg=add-registry-section[,add-registry-section]...
Fait référence à une ou plusieurs sections de complément définies par l’enregistreur INF 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 les informations par appareil dans le Registre. Une spécification HKR dans 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 complément référencée par une section DDInstall.HW.
Pour plus d’informations, consultez la directive AddReg INF.
Include=filename. inf[,filename2.inf]...
Spécifie un ou plusieurs fichiers INF fournis par le système supplémentaires qui contiennent des sections nécessaires pour installer cet appareil. Si cette entrée est spécifiée, il s’agit généralement d’une entrée Besoins .
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 une DDInstall. Section HW dans un fichier INF fourni par le système 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 de l’INF inclus.
Non pris en charge dans un INF universel
DelReg=del-registry-section[,del-registry-section]...
Fait référence à une ou plusieurs sections delete-registry-registry-sectiondéfinies par l’enregistreur INF ailleurs dans le fichier INF pour les pilotes des périphériques couverts par cette section DDInstall . Une telle section delete-registry supprime les informations de Registre obsolètes pour un périphérique/pilote précédemment installé 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 la directive DelReg INF.
BitReg=bit-registry-section[,bit-registry-section] ...
Est valide dans cette section, mais 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 la directive BitReg INF.
Remarks
Les extensions qui ne respectent pas la casse du nom de section install indiqué 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 définies par le système, .ntx86, .ntia64, .ntamd64, .ntarm et .ntarm64, consultez Création de fichiers INF pour plusieurs plateformes et systèmes d’exploitation.
N’importe quel DDInstall. La section HW doit avoir l’une des options suivantes :
- 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 Besoins 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 l’enregistreur INF. Toutefois, chaque section nommée supplémentaire doit être séparée de la suivante avec une virgule (,).
Chaque nom de section de ce type 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.
Pour plus d’informations sur l’installation d’appareils multifonctionnels, consultez Prise en charge des appareils à fonctions multiples.
Examples
Cet exemple montre comment un package de pilotes peut utiliser DDInstall. Sections HW et DDInstall. Sections services pour ajouter un pilote de fonction et un pilote de filtre pnP supérieur.
[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