Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
In diesem Abschnitt wird eine oder mehrere 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 IoRegisterDeviceInterface aufgerufen wird.
[InterfaceInstall32]
{InterfaceClassGUID}=install-interface-section[,flags]
...
Einträge
InterfaceClassGUID
Gibt einen GUID-Wert an, der die neu exportierte Geräteschnittstellenklasse identifiziert.
Um eine Instanz 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 von einer INF-AddInterface-Direktive in einem INF DDInstall verwiesen werden. Abschnitt "Schnittstellen".
Weitere Informationen zum Erstellen einer GUID finden Sie unter Verwenden von GUIDs in Treibern. Die systemdefinierte Schnittstellenklassen-GUIDS finden Sie in den entsprechenden Headern, z. B. Ks.h für die Kernelstreaming-Schnittstellen.
install-interface-section
Verweist auf einen INF-Writer-definierten Abschnitt, möglicherweise mit einer der systemdefiniert Erweiterungen, an anderer Stelle in diesem INF.
flags
Wenn angegeben, muss dieser Eintrag null sein.
Bemerkungen
Wenn eine angegebene InterfaceClassGUID nicht bereits im System installiert ist, wird diese Schnittstellenklasse als entsprechendes DDInstall installiert. Der Abschnitt "Schnittstellen" wird während der Geräteinstallation verarbeitet oder wenn der Treiber dieses Geräts den anfänglichen Aufruf von IoRegisterDeviceInterface durchführt.
Jeder Name des Installationsschnittstellenabschnitts muss innerhalb der INF-Datei eindeutig sein und muss den allgemeinen Regeln zum Definieren von Abschnittsnamen entsprechen. Weitere Informationen zu diesen Regeln finden Sie unter Allgemeine Syntaxregeln für INF-Dateien.
Jeder angegebene Abschnitt "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-section" finden Sie im ABSCHNITT "INF DDInstall".
Ab Windows Vista können Sie Eigenschaften der Geräteschnittstellenklasse festlegen, indem Sie INF-AddProperty-Direktiven in einen Abschnitt für die Schnittstelleninstallation einschließen. Sie können auch Eigenschaften der Geräteschnittstellenklasse löschen, indem Sie INF DelProperty-Direktiven in einen Abschnitt für die Schnittstelleninstallation einschließen. Sie sollten jedoch eine AddProperty- oder DelProperty-Direktive nur verwenden, um Geräteschnittstellenklasseneigenschaften zu ändern, die für Windows Vista oder neuere Versionen von Windows Betriebssystemen neu sind. Für Geräteoberflächenklasseneigenschaften, die auf Windows Server 2003, Windows XP oder Windows 2000 eingeführt wurden und entsprechende Registrierungswerteinträge enthalten, 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-Direktive finden Sie unter Verwenden der INF-AddProperty-Direktive und der INF DelProperty-Direktive.
Eine AddReg-Direktive verweist auf einen oder mehrere Add-Registry-Abschnitte, die geräteschnittstellenspezifische Informationen in der Registrierung während der Installation dieser Schnittstelle festlegen.
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 Abschnitt "install-interface-section " eine der hier gezeigten optionalen Direktiven verwenden, um schnittstellenspezifische Installationsvorgänge anzugeben.
Weitere Informationen zur Verwendung der systemdefinierten .nt, .ntx86, .ntia64, .ntamd64, .ntarm, .ntarm64-Erweiterungen finden Sie unter Creating INF Files for Multiple Platforms and Operating Systems.