OID_SWITCH_PORT_TEARDOWN

Articolo
06/15/2023

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 le estensioni del commutatore estendibili sottostanti che una porta di commutatore estendibile inizierà il processo di eliminazione. Questo processo viene avviato quando il driver del protocollo genera una richiesta del 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 .

Commenti

Il membro PortId della struttura NDIS_SWITCH_PORT_PARAMETERS specifica la porta del commutatore estendibile per cui viene eseguita la notifica di connessione. L'estensione del commutatore estendibile deve aggiornare tutte le informazioni memorizzate nella cache sulla porta ottenuta nei modi seguenti:

Emettendo 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 impostata su TRUE. Se IsActive è FALSE, l'estensione genera l'OID quando l'NET_PNP_EVENTNetEventSwitchActivate viene rilasciato 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 genera una richiesta del set OID 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 dell'commutatore estendibile aveva precedentemente rilasciato gli OID seguenti se la porta aveva una connessione della 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 le estensioni sottostanti che la connessione di rete tra la scheda di rete e la porta del commutatore estendibile è stata eliminata.

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

Dopo che l'estensione completa questa richiesta di set OID e il contatore di riferimento per la porta di commutatore estendibile è zero, il bordo del protocollo dell'interruttore estendibile genera una richiesta del 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 commutatore estendibile chiamando ReferenceSwitchPort. Un'estensione decrementa il contatore di riferimento chiamando DereferenceSwitchPort.

L'estensione deve seguire queste linee guida per gestire le richieste del set OID di OID_SWITCH_PORT_TEARDOWN:

L'estensione deve sempre inoltrare questa richiesta impostata su estensioni sottostanti. L'estensione non deve avere esito negativo nella 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 di set OID di OID_SWITCH_PORT_TEARDOWN.

Per altre informazioni sugli stati delle porte di commutatore estendibili e delle connessioni della scheda di rete, vedere Porte estendibili di commutatori Hyper-V e Stati scheda di rete.

Codici di stato restituiti

Il bordo miniport sottostante del commutatore estendibile completa la richiesta del set OID di OID_SWITCH_PORT_TEARDOWN e restituisce il codice di stato seguente.