NDIS_SWITCH_REFERENCE_SWITCH_NIC Rückruffunktion (ndis.h)

Artikel
02/29/2024

Die ReferenceSwitchNic-Funktion erhöht den Referenzindikator für den erweiterbaren Hyper-V-Switch 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 erweiterbare Hyper-V-Switcherweiterung angefügt ist. Wenn die Erweiterung NdisFGetOptionalSwitchHandlers aufruft, wird dieses Handle über den Parameter NdisSwitchContext 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 inkrementiert werden soll.

Weitere Informationen zu NDIS_SWITCH_NIC_INDEX Werten finden Sie unter Indexwerte des Netzwerkadapters.

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.

Hinweise

Die erweiterbare Switcherweiterung ruft ReferenceSwitchNic auf, um einen Verweiszähler für einen Netzwerkadapter zu erhöhen, der mit einem erweiterbaren Switchport verbunden ist. Während der Verweisindikator über einen wert ohne Zero verfügt, stellt der Protokollrand des erweiterbaren Switches keine OID-Set-Anforderung (Object Identifier) von OID_SWITCH_NIC_DELETE aus, um die Verbindung mit dem Adapter zu löschen.

Nachdem die Erweiterung ReferenceSwitchNic aufgerufen hat, muss sie DereferenceSwitchNic aufrufen, um den erweiterbaren Switchverweisindikator zu verringern.

Die Erweiterung sollte ReferenceSwitchNic aufrufen, bevor sie die folgenden Vorgänge ausführt:

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 status Angabe über den erweiterbaren Switchsteuerungspfad 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 Switchdatenpfad weitergeleitet werden. Die erweiterbare Switchschnittstelle verwaltet ihre eigenen Verweisindikatoren für Pakete, die über den Datenpfad an Ports und Netzwerkadapterverbindungen weitergeleitet werden.

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

Hinweis Wenn die Erweiterung ReferenceSwitchNic aufruft, muss sie den Aufruf nicht mit dem Code synchronisieren, der OID-Anforderungen verarbeitet. Daher ist es für die Erweiterung möglich, ReferenceSwitchNic aufzurufen, während der Protokollrand des erweiterbaren Switches eine OID-Anforderung von OID_SWITCH_NIC_DISCONNECT ausgibt. Wenn der Aufruf von ReferenceSwitchNic jedoch mit NDIS_STATUS_SUCCESS abgeschlossen wird, kann die Erweiterung weiterhin OID_SWITCH_NIC_REQUEST OID-Anforderung oder NDIS_STATUS_SWITCH_NIC_STATUS status Indikationen weiterleiten, nachdem sie die OID_SWITCH_NIC_DISCONNECT OID-Anforderung verarbeitet hat.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Unterstützt in NDIS 6.30 und höher.
Zielplattform	Desktop
Kopfzeile	ndis.h (einschließlich Ndis.h)
IRQL	<= DISPATCH_LEVEL