OID_SWITCH_PORT_TEARDOWN

Artikel
06/15/2023

Der Protokollrand des erweiterbaren Hyper-V-Switches gibt eine OID-Set-Anforderung (Object Identifier) von OID_SWITCH_PORT_TEARDOWN aus, um zugrunde liegende erweiterbare Switcherweiterungen zu benachrichtigen, dass ein erweiterbarer Switchport den Löschvorgang beginnt. Dieser Prozess wird gestartet, wenn der Protokolltreiber eine OID-Set-Anforderung von OID_SWITCH_PORT_DELETE ausgibt.

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

Bemerkungen

Der PortId-Member der NDIS_SWITCH_PORT_PARAMETERS-Struktur gibt den erweiterbaren Switchport an, für den die Verbindungsbenachrichtigung erfolgt. Die erweiterbare Switcherweiterung muss alle zwischengespeicherten Informationen über den Port aktualisieren, den sie auf folgende Weise abgerufen hat:

Durch Das Ausgeben von OID-Abfrageanforderungen von OID_SWITCH_PORT_ARRAY. Die Erweiterung gibt diese OID für FilterAttach nur aus, wenn OID_SWITCH_PARAMETERS eine NDIS_SWITCH_PARAMETERS-Struktur zurückgibt, deren IsActive auf TRUE festgelegt ist. Wenn IsActive auf FALSE festgelegt ist, gibt die Erweiterung die OID aus, wenn der NetEventSwitchActivate-NET_PNP_EVENT vom Erweiterungsminiport ausgegeben wird.
Durch Die Überprüfung der verschiedenen OID-Sätze anforderungen von OID_SWITCH_PORT_CREATE und OID_SWITCH_PORT_DELETE.

Der Protokollrand des erweiterbaren Switches gibt eine OID-Set-Anforderung von OID_SWITCH_PORT_TEARDOWN aus, um die Erweiterung zu benachrichtigen, dass ein Port gerade aus dem erweiterbaren Switch gelöscht wird. Bevor diese OID-Anforderung ausgegeben wird, hatte der Protokollrand des erweiterbaren Switches zuvor die folgenden OIDs ausgegeben, wenn der Port über eine aktive Netzwerkadapterverbindung verfügte:

OID_SWITCH_NIC_DISCONNECT, die die zugrunde liegenden Erweiterungen darüber informiert, dass der Netzwerkadapter nicht mehr mit dem port verbunden ist, der in der NDIS_SWITCH_PORT_PARAMETERS-Struktur angegeben ist.
OID_SWITCH_NIC_DELETE, die die zugrunde liegenden Erweiterungen benachrichtigt, dass die Netzwerkverbindung zwischen dem Netzwerkadapter und dem erweiterbaren Switchport gelöscht wurde.

Der Protokollrand gibt diese OID-Set-Anforderung aus, nachdem alle ausstehenden Pakete für den angegebenen erweiterbaren Switchport abgebrochen oder abgeschlossen wurden.

Nachdem die Erweiterung diese OID-Set-Anforderung abgeschlossen hat und der Verweiszähler für den erweiterbaren Switchport null ist, gibt der Protokollrand des erweiterbaren Switches eine OID-Set-Anforderung von OID_SWITCH_PORT_DELETE aus. Diese OID-Anforderung löscht den Port aus dem erweiterbaren Switch.

Hinweis Eine Erweiterung erhöht den Verweiszähler für einen erweiterbaren Switchport, indem ReferenceSwitchPort aufgerufen wird. Eine Erweiterung dekrementiert den Verweiszähler, indem DereferenceSwitchPort aufgerufen wird.

Die Erweiterung muss die folgenden Richtlinien für die Verarbeitung von OID-Satzanforderungen von OID_SWITCH_PORT_TEARDOWN befolgen:

Die Erweiterung muss diese OID-Set-Anforderung immer an zugrunde liegende Erweiterungen weiterleiten. Bei der Erweiterung darf die Anforderung nicht fehlschlagen.

Hinweis Die Erweiterung darf die NDIS_SWITCH_PORT_PARAMETERS Struktur, die der OID-Anforderung zugeordnet ist, nicht ändern.
Nachdem die Erweiterung diese OID-Anforderung weitergeleitet hat, können keine Pakete an den gelöschten Port weitergeleitet werden. Die Erweiterung kann auch keine OID-Anforderungen ausgeben oder die ReferenceSwitchPort-Funktion für den gelöschten Port aufrufen.

Hinweis Die Erweiterung darf keine OID-Set-Anforderungen von OID_SWITCH_PORT_TEARDOWN 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-Set-Anforderung von OID_SWITCH_PORT_TEARDOWN ab und gibt den folgenden status Code zurück.