OID_SWITCH_NIC_CONNECT

Articolo
06/15/2023

Il bordo del protocollo del commutatore estendibile Hyper-V emette una richiesta di set di identificatori di oggetto (OID) di OID_SWITCH_NIC_CONNECT per notificare alle estensioni del commutatore estendibili sottostanti che viene stabilita completamente una connessione di rete tra una porta del commutatore estendibile e una scheda di rete. Il bordo del protocollo notifica 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.

Osservazioni:

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 rilascia 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 rilascia l'OID quando il NET_PNP_EVENT NetEventSwitchActivate 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 di 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 di pacchetti alla connessione di rete della porta. L'estensione può anche emettere OID di 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 emette una richiesta di set OID separata 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 le schede di rete fisiche possono essere associate alla scheda di rete esterna, vedere Tipi di configurazioni della scheda di rete fisica.

Nota L'estensione non deve inviare richieste di set OID personalizzate 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.