NDIS_SWITCH_DEREFERENCE_SWITCH_NIC Rückruffunktion (ndis.h)

  • Artikel

Die DereferenceSwitchNic-Funktion dekrementiert den Referenzindikator für den erweiterbaren Hyper-V-Switch für einen Netzwerkadapter, der mit einem erweiterbaren Switchport verbunden ist. Der Verweisindikator wurde durch einen vorherigen Aufruf von ReferenceSwitchNic erhöht.

Syntax

NDIS_SWITCH_DEREFERENCE_SWITCH_NIC NdisSwitchDereferenceSwitchNic;

NDIS_STATUS NdisSwitchDereferenceSwitchNic(
  [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.

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 DereferenceSwitchNic auf, um den Verweiszähler für einen Netzwerkadapter zu dekrementieren, der mit einem erweiterbaren Switchport verbunden ist. Während der erweiterbare Switchverweisindikator einen nonzero-Wert aufweist, 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.

Die Erweiterung muss DereferenceSwitchNic aufrufen, wenn sie zuvor ReferenceSwitchNic für eine Netzwerkadapterverbindung aufgerufen hatte.

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

Weitere Informationen

NdisFGetOptionalSwitchHandler

OID_SWITCH_NIC_DELETE

ReferenceSwitchNic