OID_SWITCH_PORT_DELETE
Der Protokollrand des erweiterbaren Hyper-V-Switches gibt eine OID-Set-Anforderung (Object Identifier) von OID_SWITCH_PORT_DELETE aus, um erweiterbare Switcherweiterungen über das Löschen eines erweiterbaren Switchports zu benachrichtigen.
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 Löschbenachrichtigung erfolgt.
Wenn ein Netzwerkadapter mit dem angegebenen Port verbunden ist, löscht der Protokollrand des erweiterbaren Switches die Verbindung, bevor er den Port löscht. In diesem Fall führt der Protokollrand die folgenden Schritte aus, bevor er den Port löscht:
Der Protokollrand gibt eine OID-Set-Anforderung von OID_SWITCH_NIC_DISCONNECT aus, um die Erweiterung zu benachrichtigen, dass die Verbindung zwischen einem Netzwerkadapter und dem erweiterbaren Switchport gelöscht wird.
Nachdem alle ausstehenden Pakete für den angegebenen erweiterbaren Switchport abgebrochen oder abgeschlossen wurden, gibt der Protokollrand eine OID-Set-Anforderung von OID_SWITCH_NIC_DELETE aus, um die Erweiterung darüber zu benachrichtigen, dass die Verbindung zwischen einem Netzwerkadapter und dem erweiterbaren Switchport gelöscht wurde.
An diesem Punkt kann der Protokollrand beginnen, den Port zu löschen.
Der Protokollrand des erweiterbaren Switches führt die folgenden Schritte aus, wenn er einen erweiterbaren Switchport löscht:
Der Protokollrand des erweiterbaren Switches gibt eine OID-Set-Anforderung von OID_SWITCH_PORT_TEARDOWN aus. Diese OID-Anforderung benachrichtigt zugrunde liegende erweiterbare Switcherweiterungen über den Start des Löschvorgangs für einen erweiterbaren Switchport.
Der Protokollrand gibt eine OID-Set-Anforderung von OID_SWITCH_PORT_DELETE aus, nachdem alle OID-Anforderungen an den erweiterbaren Switchport abgeschlossen sind.
Hinweis Wenn die Erweiterung zuvor ReferenceSwitchPort aufgerufen hat, um den Verweiszähler des Ports zu erhöhen, muss sie DereferenceSwitchPort aufrufen, bevor der Protokollrand die OID_SWITCH_NIC_DELETE-Anforderung ausgibt.
Die Erweiterung muss die folgenden Richtlinien für die Verarbeitung von OID-Satzanforderungen von OID_SWITCH_PORT_DELETE befolgen:
Die Erweiterung darf die NDIS_SWITCH_PORT_PARAMETERS Struktur, die der OID-Anforderung zugeordnet ist, nicht ändern.
Die Erweiterung muss diese OID-Set-Anforderung immer an zugrunde liegende Erweiterungen weiterleiten. Bei der Erweiterung darf die Anforderung nicht fehlschlagen.
Nachdem die OID_SWITCH_PORT_DELETE Anforderung mit NDIS_STATUS_SUCCESS abgeschlossen wurde, empfängt die Erweiterung keine Pakete oder OID-Anforderungen für den gelöschten Port. Die Erweiterung kann keine Pakete an den gelöschten Port weiterleiten. Die Erweiterung kann auch keine OID-Anforderungen ausgeben oder die ReferenceSwitchPort-Funktion für den gelöschten Port aufrufen.
Hinweis Erweiterbare Switcherweiterungen dürfen keine OID-Set-Anforderungen von OID_SWITCH_PORT_DELETE 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_DELETE ab und gibt den folgenden status Code zurück.
| Statuscode | BESCHREIBUNG |
|---|---|
NDIS_STATUS_SUCCESS |
Die OID-Anforderung wurde erfolgreich abgeschlossen. |
Requirements (Anforderungen)
Version |
Unterstützt in NDIS 6.30 und höher. |
Header |
Ntddndis.h (include Ndis.h) |