INF-Anforderungen für Hyper-V Extensible Switch-Erweiterungen

Erweiterungen für erweiterbare Hyper-V-Switches werden als NDIS-Filtertreiber entwickelt. Daher basieren die INF-Anforderungen für Erweiterungen auf den INF-Anforderungen für alle NDIS-Filtertreiber. Wenn Sie eine INF-Datei für eine erweiterbare Switcherweiterung erstellen, sollten Sie die INF-Einstellungen für einen Ändern oder Überwachen des Filtertreibers verwenden. Weitere Informationen zu diesen Einstellungen finden Sie unter INF-Dateieinstellungen für Filtertreiber.

Darüber hinaus müssen Sie diese Richtlinien für INF-Dateien für erweiterbare Switcherweiterungen befolgen:

• Eine erweiterbare Switcherweiterung muss als Änderungsfiltertreiber installiert werden.

  Weitere Informationen zu den INF-Anforderungen für einen ändernden Filtertreiber finden Sie unter Konfigurieren einer INF-Datei für einen Änderungsfiltertreiber.

  Hinweis Eine Erweiterung mit einer Filterklasse von ms_switch_capture kann die gleichen Aufgaben wie ein Überwachungsfiltertreiber ausführen. Weitere Informationen finden Sie unter Typen von Filtertreibern.

• Der FilterMediaTypes-Eintrag in der Filter-INF-Datei definiert die Bindungen des Treibers an andere Treiber und Schnittstellen. Der FilterMediaTypes-Eintrag für eine erweiterbare Switcherweiterung muss den Vmnetextension-Wert enthalten. Dieser Wert gibt eine Bindung an den Erweiterungs-Miniportadapter für erweiterbare Switches an.

  Mit dem FilterMediaTypes-Eintrag kann eine durch Trennzeichen getrennte Liste von Medientypen angegeben werden. Dadurch kann die Erweiterung an eine physische Schnittstelle oder an die erweiterbare Switchschnittstelle gebunden werden.

  Das folgende Beispiel zeigt einen FilterMediaTypes-Eintrag , mit dem eine Erweiterung entweder an den physischen Ethernet-Netzwerkadapter oder an einen erweiterbaren virtuellen Netzwerkadapter gebunden werden kann.

  HKR, Ndi\Interfaces, FilterMediaTypes, , "ethernet, vmnetextension"
  

  Wenn der FilterMediaTypes-Eintrag nur den Vmnetextension-Wert angibt, wird die Erweiterung nur an die Treiberstapel für alle erweiterbaren Switches im System gebunden.

  Wenn der FilterMediaTypes-Eintragvmnetextension sowie andere Medientypen angibt, kann die Erweiterung bestimmen, ob sie innerhalb eines erweiterbaren Switchtreiberstapels gebunden ist, indem NdisFGetOptionalSwitchHandlers aufgerufen wird. Wenn die Funktion NDIS_STATUS_SUCCESS zurückgibt, wird die Erweiterung innerhalb des Erweiterungstreiberstapels gebunden. Wenn die Funktion NDIS_STATUS_NOT_SUPPORTED zurückgibt, ist die Erweiterung innerhalb des Treiberstapels für eine andere physische Netzwerkschnittstelle gebunden.

  Weitere Informationen zum FilterMediaTypes-Eintrag finden Sie unter Intermediate Driver UpperRange and LowerRange INF File Entries.For more information about the FilterMediaTypes entry, see Intermediate Driver UpperRange and LowerRange INF File Entries.

• Der FilterClass-Wert in der INF-Datei für eine Erweiterung bestimmt deren Reihenfolge in einem Filterstapel. Der FilterClass-Eintrag muss einen der Werte aus der folgenden Tabelle enthalten.

  FilterClass-Wert	BESCHREIBUNG
  ms_switch_capture	Eine Erweiterung dieser Klasse überwacht den Paketdatenverkehr. Diese Erweiterungsklasse kann jedoch keine Portrichtlinien anwenden oder Zielports für ein Paket ändern. Weitere Informationen zu dieser Erweiterungsklasse finden Sie unter Erfassen von Erweiterungen.
  ms_switch_filter	Eine Erweiterung dieser Klasse filtert den Paketdatenverkehr und erzwingt port- oder switch-Richtlinie für die Paketübermittlung über den erweiterbaren Switch. Diese Klasse von Treibern kann auch Zielports für jedes Paket basierend auf Richtlinieneinstellungen überprüfen und entfernen. Weitere Informationen zu dieser Erweiterungsklasse finden Sie unter Filtern von Erweiterungen.
  ms_switch_forward	Eine Erweiterung dieser Klasse verfügt über die gleichen Funktionen wie die ms_switch_filter Klasse. Diese Erweiterungsklasse kann auch Pakete an andere erweiterbare Switchports weiterleiten und Paketdatenverkehr an jeden erweiterbaren Switchport einfügen. Im Eingangsdatenpfad wird diese Erweiterungsklasse nach der ms_switch_filter Klasse der Erweiterung aufgerufen. Im ausgehenden Datenpfad wird diese Erweiterungsklasse vor der ms_switch_filter Klasse der Erweiterung aufgerufen. Weitere Informationen zu dieser Erweiterungsklasse finden Sie unter Weiterleitungserweiterungen. Hinweis Im erweiterbaren Switchtreiberstapel ist nur eine Erweiterung dieser Klasse zulässig.

Wenn die Erweiterung mit diesen INF-Einstellungen installiert wird, wird sie für die Bindung an jeden erweiterbaren Switch instance konfiguriert. Die Bindung wird jedoch deaktiviert und muss explizit über ein PowerShell-Cmdlet aktiviert werden. Weitere Informationen zu diesem Verfahren finden Sie unter Aktivieren von Hyper-V Extensible Switch-Erweiterungen.