OID_SWITCH_NIC_DELETE

Articolo
03/13/2025

Il bordo del protocollo del commutatore estendibile Hyper-V emette una richiesta di set di identificatori di oggetto (OID) di OID_SWITCH_NIC_DELETE allo stack di driver del commutatore estendibile. Questa richiesta OID notifica alle estensioni del commutatore estendibili sottostanti l'eliminazione di una connessione tra una porta del commutatore estendibile e una scheda di rete. Il bordo del protocollo dell'opzione estendibile notifica in precedenza alle estensioni che questa connessione viene eliminata quando ha inviato 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.

Osservazioni

Il membro PortId della struttura NDIS_SWITCH_NIC_PARAMETERS specifica la porta per cui viene effettuata la notifica di eliminazione. L'estensione del commutatore estendibile può ottenere le informazioni sui parametri per questa e altre porte sul commutatore estendibile inviando 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 effettuata la notifica di eliminazione. 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.

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

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

L'estensione deve seguire queste linee guida per la gestione delle richieste di 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 di impostazione dell'OID alle estensioni sottostanti. L'estensione non deve completare la richiesta.
L'estensione non deve inviare richieste di set OID personalizzate di OID_SWITCH_NIC_DELETE.
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_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 le schede di rete fisiche alla scheda di rete esterna, vedere Tipi di configurazioni delle schede di rete fisiche.

Per altre informazioni sugli stati delle porte commutatori estendibili e delle connessioni alle schede di rete, vedere Hyper-V Stati della porta del commutatore estendibile e della scheda di rete.

Codici di stato restituiti

Il bordo miniport sottostante dell'interruttore estendibile completa la richiesta di query OID di OID_SWITCH_NIC_DELETE e restituisce il codice di stato seguente.