NDIS_SWITCH_DEREFERENCE_SWITCH_PORT Rückruffunktion (ndis.h)

  • Artikel

Die DereferenceSwitchPort-Funktion dekrementiert den Referenzzähler des erweiterbaren Hyper-V-Switches für einen erweiterbaren Switchport. Der Verweiszähler wurde durch einen vorherigen Aufruf von ReferenceSwitchPort erhöht.

Syntax

NDIS_SWITCH_DEREFERENCE_SWITCH_PORT NdisSwitchDereferenceSwitchPort;

NDIS_STATUS NdisSwitchDereferenceSwitchPort(
  [in] NDIS_SWITCH_CONTEXT NdisSwitchContext,
  [in] NDIS_SWITCH_PORT_ID SwitchPortId
)
{...}

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 NdisSwitchContext-Parameter zurückgegeben.

[in] SwitchPortId

Ein NDIS_SWITCH_PORT_ID Wert, der den eindeutigen Bezeichner des erweiterbaren Switchports enthält, für den der erweiterbare Switchverweiszähler erhöht wird.

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 DereferenceSwitchPort auf, um den Verweiszähler für einen erweiterbaren Switchport zu dekrementieren. Während der Verweiszähler für den erweiterbaren Switch über einen Wert ungleich 0 (Null) verfügt, gibt der Protokollrand des erweiterbaren Switches keine OID-Set-Anforderung (Object Identifier) aus , die OID_SWITCH_PORT_DELETE , um den Port zu löschen.

Die Erweiterung muss DereferenceSwitchPort aufrufen, wenn sie zuvor ReferenceSwitchPort für einen erweiterbaren Switchport aufgerufen hatte.

Anforderungen

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

Weitere Informationen

NdisFGetOptionalSwitchHandlers

OID_SWITCH_PORT_DELETE

ReferenceSwitchPort