OID_SWITCH_PORT_TEARDOWN

Articolo
07/08/2024

Il bordo del protocollo del commutatore estendibile Hyper-V genera una richiesta di set di identificatori di oggetto (OID) di OID_SWITCH_PORT_TEARDOWN per notificare alle estensioni del commutatore estendibile sottostanti che una porta commutatore estendibile inizierà il processo di eliminazione. Questo processo viene avviato quando il driver del protocollo emette una richiesta di set OID di OID_SWITCH_PORT_DELETE.

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

Osservazioni:

Il membro PortId della struttura NDIS_SWITCH_PORT_PARAMETERS specifica la porta del commutatore estendibile per cui viene effettuata la notifica di connessione. L'estensione del commutatore estendibile deve aggiornare tutte le informazioni memorizzate nella cache sulla porta ottenuta 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 dal miniport dell'estensione.
Esaminando le varie richieste di set OID di OID_SWITCH_PORT_CREATE e OID_SWITCH_PORT_DELETE.

Il bordo del protocollo del commutatore estendibile emette una richiesta OID set di OID_SWITCH_PORT_TEARDOWN per notificare all'estensione che una porta è in corso di eliminazione dal commutatore estendibile. Prima di eseguire questa richiesta OID, il bordo del protocollo del commutatore estendibile aveva precedentemente emesso i seguenti IDE se la porta aveva una connessione alla scheda di rete attiva:

OID_SWITCH_NIC_DISCONNECT, che notifica alle estensioni sottostanti che la scheda di rete non è più connessa alla porta specificata nella struttura NDIS_SWITCH_PORT_PARAMETERS.
OID_SWITCH_NIC_DELETE, che notifica alle estensioni sottostanti che la connessione di rete tra la scheda di rete e la porta del commutatore estendibile è stata eliminata.

Il bordo del protocollo rilascia questa richiesta di set OID dopo che tutti i pacchetti in sospeso per la porta del commutatore estendibile specificata sono stati annullati o completati.

Dopo che l'estensione ha completato questa richiesta di set OID e il contatore di riferimento per la porta del commutatore estendibile è zero, il bordo del protocollo dell'interruttore estendibile emette una richiesta di set OID di OID_SWITCH_PORT_DELETE. Questa richiesta OID elimina la porta dal commutatore estendibile.

Nota Un'estensione incrementa il contatore di riferimento per una porta switch estendibile chiamando ReferenceSwitchPort. Un'estensione decrementa il contatore di riferimento chiamando DereferenceSwitchPort.

L'estensione deve seguire queste linee guida per la gestione delle richieste di set OID di OID_SWITCH_PORT_TEARDOWN:

L'estensione deve sempre inoltrare questa richiesta di impostazione dell'OID alle estensioni sottostanti. L'estensione non deve avere esito negativo per la richiesta.

Nota L'estensione non deve modificare la struttura NDIS_SWITCH_PORT_PARAMETERS associata alla richiesta OID.
Dopo che l'estensione inoltra questa richiesta OID, non può inoltrare pacchetti alla porta eliminata. L'estensione non può anche inviare richieste OID né chiamare la funzione ReferenceSwitchPort per la porta eliminata.

Nota L'estensione non deve emettere richieste OID set di OID_SWITCH_PORT_TEARDOWN.

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_PORT_TEARDOWN e restituisce il codice di stato seguente.