Inf InterfaceInstall32, section

Article
06/15/2023

Cette section crée une ou plusieurs classes d’interface d’appareil. Une fois qu’une classe est créée, les périphériques/pilotes installés par la suite peuvent inscrire la prise en charge de la nouvelle classe d’interface de périphérique en appelant IoRegisterDeviceInterface.

[InterfaceInstall32]
 
{InterfaceClassGUID}=install-interface-section[,flags]
...

Entrées

InterfaceClassGUID
Spécifie une valeur GUID identifiant la classe d’interface d’appareil nouvellement exportée.

Pour inscrire un instance de la classe d’interface, le pilote d’un appareil doit appeler IoRegisterDeviceInterface avec ce GUID. La valeur GUID spécifiée dans cette section peut également être référencée par une directive INF AddInterface dans un DDInstall INF. Section Interfaces.

Pour plus d’informations sur la création d’un GUID, consultez Utilisation de GUID dans les pilotes. Pour les GUID de la classe d’interface définie par le système, consultez les en-têtes appropriés, tels que Ks.h pour les interfaces de diffusion en continu du noyau.

install-interface-section
Fait référence à une section définie par l’enregistreur INF, éventuellement avec l’une des extensions définies par le système, ailleurs dans cet INF.

flags
Si elle est spécifiée, cette entrée doit être égale à zéro.

Remarques

Lorsqu’une interfaceClassGUID spécifiée n’est pas déjà installée dans le système, cette classe d’interface est installée en tant que DDInstall correspondante. La section Interfaces est traitée pendant l’installation de l’appareil ou lorsque le pilote de cet appareil effectue l’appel initial à IoRegisterDeviceInterface.

Chaque nom de section d’interface d’installation 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 section d’installation spécifiée se présente sous la forme générale suivante :

[interface-install-section] | 
[interface-install-section.nt] | 
[interface-install-section.ntx86] | 
[interface-install-section.ntia64] | (Windows XP and later versions of Windows)
[interface-install-section.ntamd64] | (Windows XP and later versions of Windows)
[interface-install-section.ntarm] | (Windows 8 and later versions of Windows)
[interface-install-section.ntarm64] (Windows 10 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)
[Copyfiles=@filename | 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)
[BitReg=bit-registry-section[,bit-registry-section]...]
[Delfiles=file-list section[, file-list-section] ...]
[Renfiles=file-list-section[, file-list-section] ...]
[UpdateInis=update-ini-section[,update-ini-section]...]
[UpdateIniFields=update-inifields-section[,update-inifields-section]...]
[Ini2Reg=ini-to-registry-section[,ini-to-registry-section]...]
...

Pour plus d’informations sur les entrées de la section d’installation de l’interface, consultez SECTION DDInstall INF.

À compter de Windows Vista, vous pouvez définir les propriétés de la classe d’interface d’appareil en incluant des directives INF AddProperty dans une section d’installation d’interface. Vous pouvez également supprimer des propriétés de classe d’interface d’appareil en incluant des directives INF DelProperty dans une section d’installation d’interface. Toutefois, vous devez utiliser une directive AddProperty ou DelProperty uniquement pour modifier les propriétés de classe d’interface d’appareil qui sont nouvelles pour Windows Vista ou les versions ultérieures des systèmes d’exploitation Windows. Pour les propriétés de classe d’interface d’appareil qui ont été introduites sur Windows Server 2003, Windows XP ou Windows 2000 et qui ont des entrées de valeur de Registre correspondantes, vous devez continuer à utiliser les directives INF AddReg et INF DelReg pour définir et supprimer les propriétés de classe d’interface 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 et de la directive DelProperty , consultez Using the INF AddProperty Directive and the INF DelProperty Directive.

Une directive AddReg fait référence à une ou plusieurs sections d’add-registry qui définissent des informations spécifiques à l’interface de périphérique dans le Registre lors de l’installation de cette interface.

Les informations de Registre relatives à cette classe d’interface doivent inclure au moins un nom convivial pour la nouvelle classe d’interface d’appareil et les informations dont les composants de niveau supérieur ont besoin lorsqu’ils s’ouvrent et utilisent cette interface.

En outre, une telle section d’interface d’installation peut utiliser l’une des directives facultatives présentées ici pour spécifier des opérations d’installation spécifiques à l’interface.

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.