Freigeben über


NDIS_SWITCH_REFERENCE_SWITCH_PORT Rückruffunktion (ndis.h)

Die ReferenceSwitchPort-Funktion erhöht den Referenzindikator für den erweiterbaren Hyper-V-Switch 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 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, für den der erweiterbare Switchverweisindikator inkrementiert wird.

Hinweis Der Parameter SwitchPortId muss den Bezeichner eines Ports angeben, der sich in einem erstellten Zustand befindet. Bezeichner für Ports, die sich im Zustand "Teardown" oder "Deleted" 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.

Hinweise

Die erweiterbare Switcherweiterung ruft ReferenceSwitchPort auf, um den Verweiszähler für einen erweiterbaren Switchport inkrementieren zu können. Während der Verweisindikator einen ungleichen Wert aufweist, stellt der Protokollrand des erweiterbaren Switches keine OID-Set-Anforderung (Object Identifier ) OID_SWITCH_PORT_DELETE aus , um den erweiterbaren Switchport zu löschen.

Nachdem die Erweiterung ReferenceSwitchPort aufgerufen hat, muss Sie DereferenceSwitchPort aufrufen, um den Verweisindikator zu dekrementieren.

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

Die Erweiterung muss ReferenceSwitchPort aufrufen, wenn sie einen Vorgang ausführt, 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_ENUM ausgibt.

Die Erweiterung ruft ReferenceSwitchPort auf, nachdem der Port den Status Port erstellt erreicht hat. Die Erweiterung darf ReferenceSwitchNic nicht aufrufen, nachdem der Port den Zustand " Port tearing down" erreicht hat. 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 sie den Aufruf nicht mit dem Code synchronisieren, der OID-Anforderungen verarbeitet. Daher ist es für die Erweiterung möglich, ReferenceSwitchPort aufzurufen, während der Protokollrand des erweiterbaren Switches eine OID-Anforderung von OID_SWITCH_PORT_TEARDOWN ausgibt. Wenn der Aufruf von ReferenceSwitchPort jedoch mit NDIS_STATUS_SUCCESS abgeschlossen wird, kann die Erweiterung weiterhin die OID_SWITCH_PORT_PROPERTY_ENUM OID-Anforderung ausstellen, nachdem sie die OID_SWITCH_PORT_TEARDOWN 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

Weitere Informationen

DereferenceSwitchNic

NdisFGetOptionalSwitchHandler

OID_SWITCH_PORT_DELETE

OID_SWITCH_PORT_PROPERTY_ENUM

OID_SWITCH_PORT_TEARDOWN