OID_SWITCH_NIC_CONNECT

Der Protokollrand des Hyper-V-erweiterbaren Switches gibt eine OID-Setanforderung (Object Identifier) von OID_SWITCH_NIC_CONNECT aus, um zugrunde liegende erweiterbare Switcherweiterungen zu benachrichtigen, dass eine Netzwerkverbindung zwischen einem erweiterbaren Switchport und einem Netzwerkadapter vollständig eingerichtet ist. Der Protokoll-Edge hat zuvor Erweiterungen benachrichtigt, dass diese Verbindung eingerichtet wird, wenn sie eine OID-Set-Anforderung von OID_SWITCH_NIC_CREATE ausgestellt hat.

Das InformationBuffer-Element der NDIS_OID_REQUEST-Struktur enthält einen Zeiger auf eine NDIS_SWITCH_NIC_PARAMETERS Struktur.

Hinweise

Das PortId-Element der NDIS_SWITCH_NIC_PARAMETERS-Struktur gibt den erweiterbaren Switchport an, für den die Verbindungsbenachrichtigung erfolgt. Die erweiterbare Switcherweiterung kann die Parameterinformationen für diesen Port und andere erweiterbare Switchports auf folgende Weise abrufen:

  • Durch Das Ausgeben von OID-Abfrageanforderungen von OID_SWITCH_PORT_ARRAY. Die Erweiterung gibt diesen OID auf FilterAttach nur aus, wenn OID_SWITCH_PARAMETERS eine NDIS_SWITCH_PARAMETERS Struktur zurückgibt, bei der IsActive auf TRUE festgelegt ist. Wenn IsActive FALSCH ist, gibt die Erweiterung das OID aus, wenn das NetEventSwitchActivate-NET_PNP_EVENT vom Erweiterungs-Miniportadapter ausgegeben wird.

  • Durch Die Prüfung der verschiedenen OID-Sätze anforderungen von OID_SWITCH_PORT_CREATE und OID_SWITCH_PORT_DELETE.

Das Indexelement der NDIS_SWITCH_NIC_PARAMETERS-Struktur gibt den Index eines Netzwerkadapters an, für den die Verbindungsbenachrichtigung erfolgt. Der Netzwerkadapter mit dem angegebenen Indexwert ist mit dem erweiterbaren Switchport verbunden, der vom PortId-Element angegeben wird. Weitere Informationen zu diesen Indexwerten finden Sie unter Netzwerkadapterindexwerte.

Wenn sie die OID-Set-Anforderung von OID_SWITCH_NIC_CONNECT empfängt, muss die Erweiterung die folgenden Richtlinien befolgen:

  • Wenn die OID_SWITCH_NIC_CONNECT Anforderung mit NDIS_STATUS_SUCCESS abgeschlossen ist, sind die Netzwerkverbindung und der erweiterbare Switchport vollständig betriebsbereit. Die Erweiterung kann Paketdatenverkehr an die Netzwerkverbindung des Ports generieren oder weiterleiten. Die Erweiterung kann auch erweiterbare Switch-OIDs oder Statusanzeigen ausgeben, die den Port als Quellport verwenden. Die Erweiterung kann auch ReferenceSwitchPort aufrufen, um den erweiterbaren Switchverweiszähler für den Port zu erhöhen.

  • Die Erweiterung darf die NDIS_SWITCH_NIC_PARAMETERS Struktur, die der OID-Anforderung zugeordnet ist, nicht ändern.

  • Die Erweiterung muss immer NdisFOidRequest aufrufen, um diese OID-Anforderung an zugrunde liegende Erweiterungen weiterzuleiten. Die Erweiterung darf die OID-Anforderung selbst nicht abschließen.

  • Der externe Netzwerkadapter für den erweiterbaren Switch kann an einen oder mehrere zugrunde liegende physische Adapter gebunden werden. Für jeden physischen Netzwerkadapter, der an den externen Netzwerkadapter gebunden ist, gibt der Protokollrand des erweiterbaren Switches eine separate OID-Setanforderung von OID_SWITCH_NIC_CONNECT aus. Jede OID-Setanforderung gibt einen anderen Indexwert für netzwerkadapterverbindung an. Weitere Informationen zu diesen Werten finden Sie unter Netzwerkadapterindexwerte.

    Die Erweiterung muss den Verbindungsstatus für jeden zugrunde liegenden physischen Adapter beibehalten, der an den externen Netzwerkadapter gebunden ist. Weitere Informationen zu den verschiedenen Konfigurationen, in denen physische Netzwerkadapter an den externen Netzwerkadapter gebunden werden können, finden Sie unter "Typen physischer Netzwerkadapterkonfigurationen".

Hinweis Die Erweiterung darf keine eigenen OID-Set-Anforderungen von OID_SWITCH_NIC_CONNECT ausgeben.

Weitere Informationen zu den Zuständen erweiterbarer Switchports und Netzwerkadapterverbindungen finden Sie unter Hyper-V Extensible Switch Port and Network Adapter States.

Rückgabestatuscodes

Der zugrunde liegende Miniportrand des erweiterbaren Schalters schließt die OID-Setanforderung von OID_SWITCH_NIC_CONNECT ab und gibt den folgenden Statuscode zurück.

Statuscode Beschreibung

NDIS_STATUS_SUCCESS

Die OID-Anforderung wurde erfolgreich abgeschlossen.

Anforderungen

Version

Unterstützt in NDIS 6.30 und höher.

Header

Ntddndis.h (Ndis.h einschließen)

Weitere Informationen


NdisFReturnNetBufferLists

NDIS_OID_REQUEST

NDIS_SWITCH_NIC_PARAMETERS

NdisFOidRequest

OID_SWITCH_NIC_CREATE

OID_SWITCH_PORT_ARRAY

ReferenceSwitchPort