OID_SWITCH_PORT_DELETE

Articolo
06/15/2023

Il bordo del protocollo dell'commutatore estendibile Hyper-V genera una richiesta di set di identificatori di oggetto (OID) di OID_SWITCH_PORT_DELETE per notificare l'eliminazione delle estensioni di un commutatore estendibile.

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 di opzione estendibile per cui viene eseguita la notifica di eliminazione.

Se una scheda di rete è connessa alla porta specificata, il bordo del protocollo dell'commutatore estendibile eliminerà la connessione prima di eliminare la porta. In questo caso, il bordo del protocollo seguirà questa procedura prima di eliminare la porta:

Il bordo del protocollo rilascia una richiesta di set OID di OID_SWITCH_NIC_DISCONNECT per notificare all'estensione che la connessione tra una scheda di rete e la porta del commutatore estendibile viene eliminata.
Dopo l'annullamento o il completamento di tutti i pacchetti in sospeso per la porta del commutatore estendibile specificato, il protocollo edge rilascia una richiesta OID set di OID_SWITCH_NIC_DELETE per notificare l'estensione che la connessione tra una scheda di rete e la porta del commutatore estendibile è stata eliminata.

A questo punto, il bordo del protocollo può iniziare a eliminare la porta.

Il bordo del protocollo dell'commutatore estendibile segue questa procedura quando elimina una porta commutatore estendibile:

Il bordo del protocollo del commutatore estendibile genera una richiesta del set OID di OID_SWITCH_PORT_TEARDOWN. Questa richiesta OID informa le estensioni del commutatore estendibili sottostanti sull'inizio del processo di eliminazione per una porta di commutatore estendibile.
Il bordo del protocollo genera una richiesta di set OID di OID_SWITCH_PORT_DELETE dopo il completamento di tutte le richieste OID alla porta del commutatore estendibile.

Nota Se l'estensione aveva precedentemente chiamato ReferenceSwitchPort per aumentare il contatore di riferimento della porta, deve chiamare DereferenceSwitchPort prima che il bordo del protocollo problemi la richiesta di OID_SWITCH_NIC_DELETE .

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

L'estensione non deve modificare la struttura NDIS_SWITCH_PORT_PARAMETERS associata alla richiesta OID.
L'estensione deve sempre inoltrare questa richiesta impostata su estensioni sottostanti. L'estensione non deve avere esito negativo nella richiesta.
Dopo aver completato la richiesta di OID_SWITCH_PORT_DELETE con NDIS_STATUS_SUCCESS, l'estensione non riceverà pacchetti o richieste OID per la porta eliminata. L'estensione 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 Le estensioni del commutatore estendibile non devono inviare richieste di set OID di OID_SWITCH_PORT_DELETE.

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