OID_SWITCH_NIC_DELETE
Der Protokollrand des erweiterbaren Hyper-V-Switches gibt eine OID-Set-Anforderung (Object Identifier) von OID_SWITCH_NIC_DELETE an den erweiterbaren Switchtreiberstapel aus. Diese OID-Anforderung benachrichtigt zugrunde liegende erweiterbare Switcherweiterungen über das Löschen einer Verbindung zwischen einem erweiterbaren Switchport und einem Netzwerkadapter. Der Protokollrand des erweiterbaren Switches hat erweiterungen zuvor benachrichtigt, dass diese Verbindung gelöscht wird, wenn eine OID-Set-Anforderung von OID_SWITCH_NIC_DISCONNECT ausgegeben wurde.
Das InformationBuffer-Element der NDIS_OID_REQUEST-Struktur enthält einen Zeiger auf eine NDIS_SWITCH_NIC_PARAMETERS-Struktur .
Bemerkungen
Der PortId-Member der NDIS_SWITCH_NIC_PARAMETERS-Struktur gibt den Port an, für den die Löschbenachrichtigung erfolgt. Die erweiterbare Switcherweiterung kann die Parameterinformationen für diesen und andere Ports auf dem erweiterbaren Switch abrufen, indem OID-Abfrageanforderungen von OID_SWITCH_PORT_ARRAY ausgegeben werden.
Der Index-Member der NDIS_SWITCH_NIC_PARAMETERS-Struktur gibt den Index eines Netzwerkadapters an, für den die Löschbenachrichtigung 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.
Bevor der Protokollrand des erweiterbaren Switches die OID_SWITCH_NIC_DELETE-Anforderung ausgibt, wird sichergestellt, dass alle ausstehenden Sende- oder Empfangspaketanforderungen für die angegebene Netzwerkadapterverbindung abgeschlossen wurden. Der Protokollrand garantiert auch, dass alle ausstehenden OID-Anforderungen für die Adapterverbindung abgeschlossen wurden, und die erweiterbaren Switch-Verweisindikatoren für die Adapterverbindung haben einen Wert von null.
Hinweis Wenn die Erweiterung einen erweiterbaren Switchverweiszähler für den Netzwerkadapter durch Aufrufen von ReferenceSwitchNic erhöht hat, wird die OID_SWITCH_NIC_DELETE-Anforderung nicht ausgegeben, während der Verweiszähler ungleich null ist. Die Erweiterung dekrementiert den Verweiszähler für den erweiterbaren Switch, indem DereferenceSwitchNic aufgerufen wird.
Die Erweiterung muss die folgenden Richtlinien für die Verarbeitung von OID-Satzanforderungen von OID_SWITCH_NIC_DELETE befolgen:
Die Erweiterung darf die NDIS_SWITCH_NIC_PARAMETERS Struktur, die der OID-Anforderung zugeordnet ist, nicht ändern.
Die Erweiterung muss diese OID-Set-Anforderung immer an zugrunde liegende Erweiterungen weiterleiten. Die Erweiterung darf die Anforderung nicht abschließen.
Die Erweiterung darf keine eigenen OID-Satzanforderungen von OID_SWITCH_NIC_DELETE ausstellen.
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_DELETE 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.
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_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) |