OID_SWITCH_NIC_DISCONNECT

Artikel
06/15/2023

Der Protokollrand des erweiterbaren Hyper-V-Switches gibt eine OID-Set-Anforderung (Object Identifier) von OID_SWITCH_NIC_DISCONNECT aus, um zugrunde liegende erweiterbare Switcherweiterungen zu benachrichtigen, dass eine Verbindung zwischen einem erweiterbaren Switchport und einem Netzwerkadapter unterbrochen wird. Nachdem die Verbindung vollständig unterbrochen wurde, gibt der Protokollrand des erweiterbaren Switches eine OID-Set-Anforderung von OID_SWITCH_NIC_DELETE aus.

Das InformationBuffer-Element der NDIS_OID_REQUEST-Struktur enthält einen Zeiger auf eine NDIS_SWITCH_NIC_PARAMETERS-Struktur .

Bemerkungen

Der Index-Member der NDIS_SWITCH_NIC_PARAMETERS-Struktur gibt den Index eines Netzwerkadapters an, für den die Trennungsbenachrichtigung erfolgt. Der Netzwerkadapter mit dem angegebenen Indexwert ist mit dem erweiterbaren Switchport verbunden, der vom PortId-Element angegeben wird. Weitere Informationen zu diesen Indexwerten finden Sie unter Indexwerte für Netzwerkadapter.

Die Erweiterung muss diese Richtlinien befolgen, wenn sie OID-Satzanforderungen von OID_SWITCH_NIC_DISCONNECT verarbeitet:

Die Erweiterung darf die NDIS_SWITCH_NIC_PARAMETERS Struktur, die der OID-Anforderung zugeordnet ist, nicht ändern.
Die OID_SWITCH_NIC_DISCONNECT-Anforderung benachrichtigt die Erweiterung nur darüber, dass die verbindung des erweiterbaren Switches zwischen dem angegebenen Netzwerkadapter und dem erweiterbaren Switchport abgerissen wird. Nachdem die Erweiterung diese OID-Anforderung verarbeitet hat, darf sie nicht wie folgt vorgehen:
- Generieren Sie jeglichen Paketdatenverkehr zur Netzwerkadapterverbindung am erweiterbaren Switchport, für den die OID_SWITCH_NIC_DISCONNECT OID-Anforderung ausgestellt wurde.
- Rufen Sie ReferenceSwitchNic auf, um den Verweiszähler für den erweiterbaren Switch für die angegebene Netzwerkadapterverbindung am erweiterbaren Switchport zu inkrementieren.
- Leiten Sie OID-Anforderungen von OID_SWITCH_NIC_REQUEST an einen zugrunde liegenden Netzwerkadapter weiter, für den die OID_SWITCH_NIC_DISCONNECT OID-Anforderung ausgestellt wurde.
  
  Hinweis Wenn die Erweiterung ReferenceSwitchNic genannt wird, um den erweiterbaren Switch-Verweiszähler zu erhöhen, bevor die OID_SWITCH_NIC_DISCONNECT ausgestellt wird, kann die Erweiterung weiterhin OID-Anforderungen weiterleiten oder ursprünglich erstellen.
- Weiterleiten oder Erstellen von NDIS status Hinweise auf NDIS_STATUS_SWITCH_NIC_STATUS von einem zugrunde liegenden Netzwerkadapter, für den die OID_SWITCH_NIC_DISCONNECT OID-Anforderung ausgestellt wurde.
  
  Hinweis Wenn die Erweiterung ReferenceSwitchNic genannt wird, um den erweiterbaren Switch-Verweiszähler zu erhöhen, bevor der OID_SWITCH_NIC_DISCONNECT ausgestellt wird, kann die Erweiterung weiterhin NDIS-status Anzeigen weiterleiten oder von ihnen stammen.
  
  Hinweis Wenn die Erweiterung, die zuvor ReferenceSwitchNic zum Inkrementieren des erweiterbaren Switchverweiszählers aufgerufen hat, muss sie ihre Aufrufe zum Erstellen oder Weiterleiten von OID-Anforderungen oder NDIS-status-Hinweisen nicht mit ihrem Code synchronisieren, der OID-Anforderungen des erweiterbaren Hyper-V-Switches verwaltet. Nachdem die Erweiterung den Verweiszähler inkrementiert hat, gibt die erweiterbare Switchschnittstelle keine OID-Set-Anforderung von OID_SWITCH_NIC_DELETE aus.
Die Erweiterung muss diese OID-Set-Anforderung immer an zugrunde liegende Erweiterungen weiterleiten. Die Erweiterung darf die Anforderung nicht abschließen.
Der erweiterbare externe Switch-Netzwerkadapter kann an einen oder mehrere zugrunde liegende physische Adapter gebunden werden. Für jeden physischen Netzwerkadapter, der an den externen Netzwerkadapter gebunden ist, gibt der Protokollrand des erweiterbaren Switches eine separate OID-Satzanforderung von OID_SWITCH_NIC_DISCONNECT aus. Jede OID-Satzanforderung gibt einen anderen Wert für den Netzwerkadapterverbindungsindex an. Weitere Informationen zu diesen Indexwerten finden Sie unter Indexwerte für Netzwerkadapter.

Die Erweiterung muss den Verbindungsstatus für jeden zugrunde liegenden physischen Adapter beibehalten. Weitere Informationen zu den verschiedenen Konfigurationen, in denen physische Netzwerkadapter an den externen Netzwerkadapter gebunden werden können, finden Sie unter Typen physischer Netzwerkadapterkonfigurationen.

Hinweis Die Erweiterung darf keine eigenen OID-Satzanforderungen von OID_SWITCH_NIC_DISCONNECT ausgeben.

Weitere Informationen zu den Zuständen von erweiterbaren Switchports und Netzwerkadapterverbindungen finden Sie unter Hyper-V Extensible Switch Port und Netzwerkadapterstatus.

Zurückgeben von Statuscodes

Der zugrunde liegende Miniportrand des erweiterbaren Schalters schließt die OID-Abfrageanforderung von OID_SWITCH_NIC_DISCONNECT ab und gibt den folgenden status Code zurück.