NDIS_SWITCH_DEREFERENCE_SWITCH_NIC Rückruffunktion (ndis.h)

Die DereferenceSwitchNic-Funktion erhöht den Hyper-V erweiterbaren Switchverweiszähler für einen Netzwerkadapter, der mit einem erweiterbaren Switchport verbunden ist. Der Referenzzähler wurde durch einen vorherigen Aufruf von ReferenceSwitchNicerhö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 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.

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 DereferenceSwitchNic auf, um den Referenzzähler für einen Netzwerkadapter zu verringern, der mit einem erweiterbaren Switchport verbunden ist. Während der Referenzzähler für erweiterbare Schalter 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.

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

Anforderungen

Siehe auch

NdisFGetOptionalSwitchHandlers

OID_SWITCH_NIC_DELETE

ReferenceSwitchNic-