OID_SWITCH_NIC_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_NIC_DELETE allo stack di driver di commutatore estendibile. Questa richiesta OID informa le estensioni del commutatore estendibili sottostanti sull'eliminazione di una connessione tra una porta commutatore estendibile e una scheda di rete. Il bordo del protocollo dell'commutatore estendibile notifica in precedenza le estensioni che questa connessione viene eliminata quando ha rilasciato una richiesta di set OID di OID_SWITCH_NIC_DISCONNECT.

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 per cui viene eseguita la notifica di eliminazione. L'estensione del commutatore estendibile può ottenere le informazioni sui parametri per questa e altre porte nel commutatore estendibile eseguendo richieste di query OID di OID_SWITCH_PORT_ARRAY.

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

Prima che il bordo del protocollo del commutatore estendibile verifichi la richiesta di OID_SWITCH_NIC_DELETE, garantisce che tutte le richieste di invio o ricezione dei pacchetti in sospeso per la connessione della scheda di rete specificata siano state completate. Il bordo del protocollo garantisce inoltre che tutte le richieste OID in sospeso per la connessione della scheda siano state completate e i contatori di riferimento dell'interruttore estendibile per la connessione della scheda hanno un valore zero.

Nota Se l'estensione ha incrementato un contatore di riferimento di commutatore estendibile per la scheda di rete chiamando ReferenceSwitchNic, la richiesta di OID_SWITCH_NIC_DELETE non viene emessa mentre il contatore di riferimento non è zero. L'estensione decrementa il contatore di riferimento del commutatore estendibile chiamando DereferenceSwitchNic.

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

L'estensione non deve modificare la struttura NDIS_SWITCH_NIC_PARAMETERS associata alla richiesta OID.
L'estensione deve sempre inoltrare questa richiesta impostata su estensioni sottostanti. L'estensione non deve completare la richiesta.
L'estensione non deve emettere richieste di set OID personalizzate di OID_SWITCH_NIC_DELETE.
L'adattatore di rete esterna estendibile può essere associato 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 di set OID separata di OID_SWITCH_NIC_DELETE. Ogni richiesta di set OID specifica un valore di indice di connessione della scheda di rete diverso. Per altre informazioni su questi valori di indice, vedere Valori di indice della scheda di rete.

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

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