OID_SWITCH_PORT_TEARDOWN
Der Protokollrand des Hyper-V-erweiterbaren Switches gibt eine OID-Setanforderung (Object Identifier) von OID_SWITCH_PORT_TEARDOWN aus, um zugrunde liegende erweiterbare Switcherweiterungen zu benachrichtigen, dass ein erweiterbarer Switchport mit dem Löschvorgang beginnt. Dieser Prozess wird gestartet, wenn der Protokolltreiber eine OID-Setanforderung 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.
Hinweise
Das PortId-Element der NDIS_SWITCH_PORT_PARAMETERS-Struktur gibt den erweiterbaren Switchport an, für den die Verbindungsbenachrichtigung erfolgt. Die erweiterbare Switcherweiterung muss alle zwischengespeicherten Informationen zum Port aktualisieren, den sie auf folgende Weise erhalten hat:
Durch Das Ausgeben von OID-Abfrageanforderungen von OID_SWITCH_PORT_ARRAY. Die Erweiterung gibt diesen OID auf FilterAttach nur aus, wenn OID_SWITCH_PARAMETERS eine NDIS_SWITCH_PARAMETERS Struktur zurückgibt, bei der IsActive auf TRUE festgelegt ist. Wenn IsActive FALSCH ist, gibt die Erweiterung das OID aus, wenn das NetEventSwitchActivate-NET_PNP_EVENT vom Erweiterungs-Miniport ausgegeben wird.
Durch Die Prü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-Setanforderung von OID_SWITCH_PORT_TEARDOWN aus, um die Erweiterung darüber zu benachrichtigen, dass ein Port aus dem erweiterbaren Switch gelöscht wird. Bevor diese OID-Anforderung ausgestellt 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 zugrunde liegende Erweiterungen benachrichtigt haben, 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 zugrunde liegende Erweiterungen benachrichtigt haben, dass die Netzwerkverbindung zwischen dem Netzwerkadapter und dem erweiterbaren Switchport gelöscht wurde.
Der Protokoll-Edge 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-Setanforderung abgeschlossen hat und der Referenzzähler für den erweiterbaren Switchport null ist, gibt der Protokollrand des erweiterbaren Schalters eine OID-Setanforderung von OID_SWITCH_PORT_DELETE aus. Diese OID-Anforderung löscht den Port vom erweiterbaren Switch.
Beachten Sie, dass eine Erweiterung den Referenzzähler für einen erweiterbaren Switchport durch Aufrufen von ReferenceSwitchPort erhöht. Eine Erweiterung erhöht den Verweiszähler durch Aufrufen von DereferenceSwitchPort.
Die Erweiterung muss die folgenden Richtlinien für die Behandlung von OID-Set-Anforderungen von OID_SWITCH_PORT_TEARDOWN befolgen:
Die Erweiterung muss diese OID-Setanforderung immer an zugrunde liegende Erweiterungen weiterleiten. Die 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 weiterleitet, 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-Satzanforderungen von OID_SWITCH_PORT_TEARDOWN ausgeben.
Weitere Informationen zu den Zuständen erweiterbarer Switchports und Netzwerkadapterverbindungen finden Sie unter Hyper-V Extensible Switch Port and Network Adapter States.
Rückgabestatuscodes
Der zugrunde liegende Miniportrand des erweiterbaren Schalters schließt die OID-Setanforderung von OID_SWITCH_PORT_TEARDOWN ab und gibt den folgenden Statuscode zurück.
| Statuscode | Beschreibung |
|---|---|
NDIS_STATUS_SUCCESS |
Die OID-Anforderung wurde erfolgreich abgeschlossen. |
Anforderungen
Version |
Unterstützt in NDIS 6.30 und höher. |
Header |
Ntddndis.h (Ndis.h einschließen) |