Abschnitt "INF InterfaceInstall32"

Artikel
06/15/2023

In diesem Abschnitt werden mindestens eine neue Geräteschnittstellenklassen erstellt. Nachdem eine neue Klasse erstellt wurde, können anschließend installierte Geräte/Treiber die Unterstützung für die neue Geräteschnittstellenklasse registrieren, indem Sie IoRegisterDeviceInterface aufrufen.

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

Einträge

InterfaceClassGUID
Gibt einen GUID-Wert an, der die neu exportierte Geräteschnittstellenklasse identifiziert.

Um eine instance der Schnittstellenklasse zu registrieren, muss der Treiber eines Geräts IoRegisterDeviceInterface mit dieser GUID aufrufen. Auf den angegebenen GUID-Wert in diesem Abschnitt kann auch eine INF AddInterface-Direktive in einem INF DDInstall verweisen. Abschnitt "Schnittstellen".

Weitere Informationen zum Erstellen einer GUID finden Sie unter Verwenden von GUIDs in Treibern. Für die systemdefinierte Schnittstellenklasse GUIDS finden Sie die entsprechenden Header, z . B. Ks.h für die Kernel-Streamingschnittstellen.

install-interface-section
Verweist auf einen inF-Writer definierten Abschnitt, möglicherweise mit einer der vom System definierten Erweiterungen, an anderer Stelle in diesem INF.

flags
Wenn angegeben, muss dieser Eintrag 0 sein.

Hinweise

Wenn eine angegebene InterfaceClassGUID noch nicht im System installiert ist, wird diese Schnittstellenklasse als entsprechende DDInstall installiert. Der Abschnitt Schnittstellen wird während der Geräteinstallation oder beim erstmaligen Aufruf von IoRegisterDeviceInterface durch den Treiber des Geräts verarbeitet.

Jeder Installationsschnittstellenabschnittsname muss innerhalb der INF-Datei eindeutig sein und den allgemeinen Regeln zum Definieren von Abschnittsnamen entsprechen. Weitere Informationen zu diesen Regeln finden Sie unter Allgemeine Syntaxregeln für INF-Dateien.

Jeder angegebene install-interface-section weist die folgende allgemeine Form auf:

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

Weitere Informationen zu den Einträgen im Abschnitt interface-install-finden Sie im Abschnitt INF DDInstall.

Ab Windows Vista können Sie Eigenschaften der Geräteschnittstellenklasse festlegen, indem Sie INF AddProperty-Anweisungen in einen Abschnitt zur Schnittstelleninstallation einschließen. Sie können Geräteschnittstellenklasseneigenschaften auch löschen, indem Sie INF DelProperty-Anweisungen in einen Abschnitt zur Schnittstelleninstallation einschließen. Sie sollten jedoch eine AddProperty - oder DelProperty-Direktive nur verwenden, um Eigenschaften der Geräteschnittstellenklasse zu ändern, die für Windows Vista oder höhere Versionen von Windows-Betriebssystemen neu sind. Für Geräteschnittstellenklasseneigenschaften, die unter Windows Server 2003, Windows XP oder Windows 2000 eingeführt wurden und entsprechende Registrierungswerteinträge aufweisen, sollten Sie weiterhin INF AddReg-Direktiven und INF DelReg-Direktiven verwenden, um die Eigenschaften der Geräteschnittstellenklasse festzulegen und zu löschen. Diese Richtlinien gelten für systemdefinierte Eigenschaften und benutzerdefinierte Eigenschaften. Weitere Informationen zur Verwendung der AddProperty-Direktive und der DelProperty-Anweisung finden Sie unter Verwenden der INF-AddProperty-Direktive und der INF DelProperty-Direktive.

Eine AddReg-Direktive verweist auf einen oder mehrere Add-Registry-Abschnitte, in denen geräteschnittstellenspezifische Informationen in der Registrierung während der Installation dieser Schnittstelle festgelegt werden.

Die Registrierungsinformationen zu dieser Schnittstellenklasse sollten mindestens einen Anzeigenamen für die neue Geräteschnittstellenklasse und alle Informationen enthalten, die die Komponenten der höheren Ebene benötigen, wenn sie diese Schnittstelle öffnen und verwenden.

Darüber hinaus kann ein solcher install-interface-section eine der hier gezeigten optionalen Anweisungen verwenden, um schnittstellenspezifische Installationsvorgänge anzugeben.

Weitere Informationen zur Verwendung der systemdefinierten Erweiterungen .nt, .ntx86, .ntia64, .ntamd64, .ntarm, .ntarm, .ntarm64 finden Sie unter Erstellen von INF-Dateien für mehrere Plattformen und Betriebssysteme.