NDIS_SWITCH_REFERENCE_SWITCH_PORT Rückruffunktion (ndis.h)

Die ReferenceSwitchPort--Funktion erhöht den Hyper-V erweiterbaren Switchverweiszähler für einen erweiterbaren Switchport.

Syntax

NDIS_SWITCH_REFERENCE_SWITCH_PORT NdisSwitchReferenceSwitchPort;

NDIS_STATUS NdisSwitchReferenceSwitchPort(
  [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 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, für den der erweiterbare Switchverweisindikator erhöht wird.

Hinweis Der Parameter SwitchPortId muss den Bezeichner eines Ports angeben, der sich in einem erstellten Zustand befindet. Bezeichner für Ports, die sich in einem Abbruch- oder gelöschten Zustand befinden, können nicht angegeben werden. Weitere Informationen zu Portzustä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 ReferenceSwitchPort auf, um den Referenzzähler für einen erweiterbaren Switchport zu erhöhen. Während der Referenzzähler einen Wert ungleich Null aufweist, gibt der Protokollrand des erweiterbaren Schalters keine Objekt-ID -Setanforderung (OID) von OID_SWITCH_PORT_DELETE aus, um den erweiterbaren Switchport zu löschen.

Nachdem die Erweiterung ReferenceSwitchPort-aufgerufen hat, muss DereferenceSwitchPort- aufgerufen werden, um den Verweiszähler zu verringern.

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

Die Erweiterung muss ReferenceSwitchPort- aufrufen, wenn ein Vorgang ausgeführt wird, der erfordert, dass sich der Port in einem aktiven Zustand befindet. Beispielsweise muss die Erweiterung ReferenceSwitchPort- aufrufen, bevor sie eine OID-Methodenanforderung von OID_SWITCH_PORT_PROPERTY_ENUMausgibt.

Die Erweiterung ruft ReferenceSwitchPort auf, nachdem der Port den Port erreicht hat, der Zustand erstellt wurde. Die Erweiterung darf ReferenceSwitchNic- nicht aufrufen, nachdem der Port den Port erreicht hat, der Zustand abreißt. Weitere Informationen zu diesen Zuständen finden Sie unter Hyper-V Extensible Switch Port and Network Adapter States.

Hinweis Wenn die Erweiterung ReferenceSwitchPort-aufruft, muss der Aufruf nicht mit seinem Code synchronisiert werden, der OID-Anforderungen verarbeitet. Daher ist es möglich, dass die Erweiterung ReferenceSwitchPort aufruft, während der Protokollrand des erweiterbaren Schalters eine OID-Anforderung von OID_SWITCH_PORT_TEARDOWNausgibt. Wenn der Aufruf von ReferenceSwitchPort jedoch mit NDIS_STATUS_SUCCESS abgeschlossen ist, kann die Erweiterung die OID_SWITCH_PORT_PROPERTY_ENUM OID-Anforderung weiterhin ausstellen, nachdem sie die OID_SWITCH_PORT_TEARDOWN 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

Siehe auch

DereferenceSwitchNic

NdisFGetOptionalSwitchHandlers

OID_SWITCH_PORT_DELETE

OID_SWITCH_PORT_PROPERTY_ENUM

OID_SWITCH_PORT_TEARDOWN