OID_SWITCH_NIC_CONNECT

Articolo
06/15/2023

Il bordo del protocollo del commutatore estendibile Hyper-V genera una richiesta di set OID (Object Identifier) di OID_SWITCH_NIC_CONNECT per notificare alle estensioni del commutatore estendibile sottostanti che viene stabilita completamente una connessione di rete tra una porta commutatore estendibile e una scheda di rete. Il bordo del protocollo notificava in precedenza le estensioni che questa connessione viene stabilita quando ha emesso una richiesta di set OID di OID_SWITCH_NIC_CREATE.

Il membro InformationBuffer della struttura NDIS_OID_REQUEST contiene un puntatore a una struttura NDIS_SWITCH_NIC_PARAMETERS .

Commenti

Il membro PortId della struttura NDIS_SWITCH_NIC_PARAMETERS specifica la porta del commutatore estendibile per cui viene effettuata la notifica di connessione. L'estensione del commutatore estendibile può ottenere le informazioni sui parametri per questa porta e altre porte switch estendibili nei modi seguenti:

Inviando richieste di query OID di OID_SWITCH_PORT_ARRAY. L'estensione genera questo OID in FilterAttach solo quando OID_SWITCH_PARAMETERS restituisce una struttura NDIS_SWITCH_PARAMETERS con IsActive impostato su TRUE. Se IsActive è FALSE, l'estensione genera l'OID quando il NET_PNP_EVENTNetEventSwitchActivate viene generato dall'adattatore miniport dell'estensione.
Esaminando le varie richieste di set OID di OID_SWITCH_PORT_CREATE e OID_SWITCH_PORT_DELETE.

Il membro Index della struttura NDIS_SWITCH_NIC_PARAMETERS specifica l'indice di una scheda di rete per cui viene effettuata la notifica di connessione. La scheda di rete con il valore Index specificato è connessa alla porta del commutatore estendibile specificata dal membro PortId . Per altre informazioni su questi valori di indice, vedere Valori di indice della scheda di rete.

Quando riceve la richiesta del set OID di OID_SWITCH_NIC_CONNECT, l'estensione deve seguire queste linee guida:

Quando la richiesta di OID_SWITCH_NIC_CONNECT viene completata con NDIS_STATUS_SUCCESS, la connessione di rete e la porta del commutatore estendibile sono completamente operative. L'estensione può generare o inoltrare il traffico dei pacchetti alla connessione di rete della porta. L'estensione può anche emettere OID del commutatore estendibile o indicazioni di stato che usano la porta come porta di origine. L'estensione può anche chiamare ReferenceSwitchPort per incrementare il contatore di riferimento del commutatore estendibile per la porta.
L'estensione non deve modificare la struttura NDIS_SWITCH_NIC_PARAMETERS associata alla richiesta OID.
L'estensione deve sempre chiamare NdisFOidRequest per inoltrare questa richiesta OID alle estensioni sottostanti. L'estensione non deve completare la richiesta OID stessa.
La scheda di rete esterna del commutatore estendibile può essere associata a una o più schede fisiche sottostanti. Per ogni scheda di rete fisica associata alla scheda di rete esterna, il bordo del protocollo del commutatore estendibile genera una richiesta separata di set OID di OID_SWITCH_NIC_CONNECT. Ogni richiesta di set OID specifica un valore di indice di connessione della scheda di rete diverso. Per altre informazioni su questi valori, vedere Valori di indice della scheda di rete.

L'estensione deve mantenere lo stato di connessione per ogni scheda fisica sottostante associata alla scheda di rete esterna. Per altre informazioni sulle diverse configurazioni in cui è possibile associare le schede di rete fisiche alla scheda di rete esterna, vedere Tipi di configurazioni della scheda di rete fisica.

Nota L'estensione non deve eseguire richieste del proprio set OID di OID_SWITCH_NIC_CONNECT.

Per altre informazioni sugli stati delle porte del commutatore estendibile e delle connessioni alle schede di rete, vedere Hyper-V Extensible Switch Port and Network Adapter States.For more information about the states of extensible switch ports and network adapter connections, see Hyper-V Extensible Switch Port and Network Adapter States.

Codici di stato restituiti

Il bordo miniport sottostante dell'interruttore estendibile completa la richiesta del set OID di OID_SWITCH_NIC_CONNECT e restituisce il codice di stato seguente.