NDIS_SWITCH_REFERENCE_SWITCH_NIC Rückruffunktion (ndis.h)

Artikel
02/07/2025

Die ReferenceSwitchNic--Funktion erhöht den Hyper-V erweiterbaren Switchverweiszähler für einen Netzwerkadapter, der mit einem erweiterbaren Switchport verbunden ist.

Syntax

NDIS_SWITCH_REFERENCE_SWITCH_NIC NdisSwitchReferenceSwitchNic;

NDIS_STATUS NdisSwitchReferenceSwitchNic(
  [in] NDIS_SWITCH_CONTEXT NdisSwitchContext,
  [in] NDIS_SWITCH_PORT_ID SwitchPortId,
  [in] NDIS_SWITCH_NIC_INDEX SwitchNicIndex
)
{...}

Parameter

[in] NdisSwitchContext

Ein NDIS_SWITCH_CONTEXT Wert, der das Handle des erweiterbaren Switchmoduls enthält, an das die Hyper-V erweiterbaren Switcherweiterung angefügt ist. Wenn die Erweiterung NdisFGetOptionalSwitchHandlersaufruft, wird dieses Handle über den NdisSwitchContext Parameter zurückgegeben.

[in] SwitchPortId

Ein NDIS_SWITCH_PORT_ID Wert, der den eindeutigen Bezeichner des erweiterbaren Switchports enthält, mit dem der virtuelle Netzwerkadapter verbunden ist.

[in] SwitchNicIndex

Ein NDIS_SWITCH_NIC_INDEX Wert, der den Index des virtuellen Netzwerkadapters angibt, für den der erweiterbare Switchverweisindikator erhöht werden soll.

Weitere Informationen zu NDIS_SWITCH_NIC_INDEX Werten finden Sie unter Netzwerkadapterindexwerte.

Hinweis Dieser Parameter muss den Indexwert eines Netzwerkadapters angeben, der sich in einem verbundenen Zustand befindet. Indexwerte für Netzwerkadapter, die sich in einem erstellten oder getrennten Zustand befinden, können nicht angegeben werden. Weitere Informationen zu Netzwerkverbindungszuständen finden Sie unter Hyper-V Extensible Switch Port and Network Adapter States.

Rückgabewert

Wenn der Aufruf erfolgreich ist, gibt die Funktion NDIS_STATUS_SUCCESS zurück. Andernfalls wird ein NDIS_STATUS_Xxx Fehlercode zurückgegeben, der in Ndis.h definiert ist.

Bemerkungen

Die erweiterbare Switcherweiterung ruft ReferenceSwitchNic auf, um einen Referenzzähler für einen Netzwerkadapter zu erhöhen, der mit einem erweiterbaren Switchport verbunden ist. Während der Referenzzähler einen Wert ungleich Null aufweist, gibt der Protokollrand des erweiterbaren Schalters keine OID-Setanforderung (Object Identifier) von OID_SWITCH_NIC_DELETE aus, um die Verbindung mit dem Adapter zu löschen.

Nachdem die Erweiterung ReferenceSwitchNic-aufgerufen hat, muss DereferenceSwitchNic- aufgerufen werden, um den erweiterbaren Switchverweiszähler zu verringern.

Die Erweiterung sollte ReferenceSwitchNic- aufrufen, bevor die folgenden Vorgänge ausgeführt werden:

Leitet eine OID_SWITCH_NIC_REQUEST OID-Anforderung über den erweiterbaren Switchsteuerungspfad an einen zugrunde liegenden physischen Netzwerkadapter weiter.
Weitere Informationen finden Sie unter Verwalten von OID-Anforderungen an physische Netzwerkadapter.
Leitet eine NDIS_STATUS_SWITCH_NIC_STATUS Statusanzeige über den erweiterbaren Schaltersteuerungspfad von einem zugrunde liegenden externen Adapter weiter.
Weitere Informationen finden Sie unter Verwalten von NDIS-Statusanzeigen von physischen Netzwerkadaptern.

Hinweis Die Erweiterung darf ReferenceSwitchNic nicht aufrufen, wenn Pakete über den erweiterbaren Switch-Datenpfad weitergeleitet werden. Die erweiterbare Switchschnittstelle verwaltet ihre eigenen Referenzzähler für Pakete, die an Ports und Netzwerkadapterverbindungen über den Datenpfad weitergeleitet werden.

Die Erweiterung ruft ReferenceSwitchNic auf, nachdem die Netzwerkadapterverbindung die Netzwerkadapterverbindung erreicht hat, die Zustand erstellt wurde. Die Erweiterung darf ReferenceSwitchNic- nicht aufrufen, nachdem die Verbindung den Netzwerkadapter getrennt erreicht hat, oder Netzwerkadapter Status gelöscht wurde. Weitere Informationen zu diesen Zuständen finden Sie unter Hyper-V Extensible Switch Port and Network Adapter States.

Hinweis Wenn die Erweiterung ReferenceSwitchNicaufruft, muss der Aufruf nicht mit seinem Code synchronisiert werden, der OID-Anforderungen verarbeitet. Daher ist es möglich, dass die Erweiterung ReferenceSwitchNic aufruft, während der Protokollrand des erweiterbaren Schalters eine OID-Anforderung von OID_SWITCH_NIC_DISCONNECTausgibt. Wenn der Aufruf von ReferenceSwitchNic jedoch mit NDIS_STATUS_SUCCESS abgeschlossen ist, kann die Erweiterung weiterhin OID_SWITCH_NIC_REQUEST OID-Anforderung weiterleiten oder statusanzeigen NDIS_STATUS_SWITCH_NIC_STATUS, nachdem sie die OID_SWITCH_NIC_DISCONNECT OID-Anforderung verarbeitet hat.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Unterstützt in NDIS 6.30 und höher.
Zielplattform-	Desktop
Header-	ndis.h (include Ndis.h)
IRQL-	<= DISPATCH_LEVEL