Sezione INF InterfaceInstall32

Articolo
02/07/2024

Questa sezione crea una o più nuove classi di interfaccia del dispositivo. Dopo la creazione di una nuova classe, i dispositivi o i driver installati successivamente possono registrare il supporto per la nuova classe di interfaccia del dispositivo chiamando IoRegisterDeviceInterface.

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

Voci

InterfaceClassGUID
Specifica un valore GUID che identifica la classe di interfaccia del dispositivo appena esportata.

Per registrare un'istanza della classe di interfaccia, il driver di un dispositivo deve chiamare IoRegisterDeviceInterface con questo GUID. Il valore GUID specificato in questa sezione può essere fatto riferimento anche da una direttiva INF AddInterface in un DDInstall INF. Sezione Interfacce.

Per altre informazioni su come creare un GUID, vedere Uso di GUID nei driver. Per il GUIDS della classe di interfaccia definita dal sistema, vedere le intestazioni appropriate, ad esempio Ks.h per le interfacce di streaming del kernel.

install-interface-section
Fa riferimento a una sezione definita dal writer INF, possibilmente con una delle estensioni definite dal sistema, altrove in questo INF.

flags
Se specificato, questa voce deve essere zero.

Commenti

Quando un interfaceClassGUID specificato non è già installato nel sistema, tale classe di interfaccia viene installata come DDInstall corrispondente. La sezione Interfacce viene elaborata durante l'installazione del dispositivo o quando il driver del dispositivo effettua la chiamata iniziale a IoRegisterDeviceInterface.

Ogni nome della sezione install-interface deve essere univoco all'interno del file INF e deve seguire le regole generali per definire i nomi di sezione. Per altre informazioni su queste regole, vedere Regole di sintassi generali per i file INF.

Qualsiasi sezione di installazione specificata ha il formato generale seguente:

[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]...]
...

Per altre informazioni sulle voci nella sezione interface-install-section, vedere sezione INF DDInstall.

A partire da Windows Vista, è possibile impostare le proprietà della classe dell'interfaccia del dispositivo , incluse le direttive INF AddProperty in una sezione di installazione dell'interfaccia. È anche possibile eliminare le proprietà della classe dell'interfaccia del dispositivo includendo le direttive INF DelProperty in una sezione di installazione dell'interfaccia. Tuttavia, è consigliabile usare una direttiva AddProperty o DelProperty solo per modificare le proprietà della classe dell'interfaccia del dispositivo nuove a Windows Vista o versioni successive dei sistemi operativi Windows. Per le proprietà della classe dell'interfaccia del dispositivo introdotte in Windows Server 2003, Windows XP o Windows 2000 e che hanno voci di valore del Registro di sistema corrispondenti, è consigliabile continuare a usare le direttive INF AddReg e le direttive INF DelReg per impostare ed eliminare le proprietà della classe dell'interfaccia del dispositivo. Queste linee guida si applicano alle proprietà definite dal sistema e alle proprietà personalizzate. Per altre informazioni sull'uso della direttiva AddPropertye della direttiva DelProperty, vedere Uso della direttiva INF AddProperty e della direttiva INF DelProperty.

Una direttiva AddReg fa riferimento a una o più sezioni del Registro di sistema aggiuntive che impostano informazioni specifiche dell'interfaccia del dispositivo nel Registro di sistema durante l'installazione di questa interfaccia.

Le informazioni del Registro di sistema su questa classe di interfaccia devono includere almeno un nome descrittivo per la nuova classe di interfaccia del dispositivo e qualsiasi informazione sui componenti di livello superiore necessari quando aprono e usano questa interfaccia.

Inoltre, tale sezione install-interface-userà una delle direttive facoltative illustrate qui per specificare operazioni di installazione specifiche dell'interfaccia.

Per altre informazioni su come usare le estensioni .nt, .ntx86, .ntia64, .ntamd64, .ntarm, .ntarm64, vedere Creazione di file INF per più piattaforme e sistemi operativi.