OID_SWITCH_NIC_DISCONNECT

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_DISCONNECT per notificare le estensioni del commutatore estendibili sottostanti che una connessione tra una porta di commutatore estendibile e una scheda di rete viene interrotta. Dopo che la connessione viene completamente interrotta, il bordo del protocollo dell'commutatore estendibile emetterà una richiesta di set OID di OID_SWITCH_NIC_DELETE.

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

Commenti

Il membro Index della struttura NDIS_SWITCH_NIC_PARAMETERS specifica l'indice di una scheda di rete per cui viene effettuata la notifica di disconnessione. 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.

L'estensione deve seguire queste linee guida quando gestisce le richieste del set OID di OID_SWITCH_NIC_DISCONNECT:

L'estensione non deve modificare la struttura NDIS_SWITCH_NIC_PARAMETERS associata alla richiesta OID.
La richiesta di OID_SWITCH_NIC_DISCONNECT notifica solo all'estensione che la connessione del commutatore estendibile viene disattivata tra la scheda di rete specificata e la porta del commutatore estendibile. Dopo che l'estensione gestisce questa richiesta OID, non deve eseguire le operazioni seguenti:
- Generare qualsiasi traffico di pacchetti alla connessione della scheda di rete sulla porta del commutatore estendibile per cui è stata rilasciata la richiesta OID OID_SWITCH_NIC_DISCONNECT.
- Chiamare ReferenceSwitchNic per incrementare il contatore di riferimento del commutatore estendibile per la connessione della scheda di rete specificata sulla porta del commutatore estendibile.
- Inoltrare o originare richieste OID di OID_SWITCH_NIC_REQUEST a una scheda di rete sottostante per cui è stata rilasciata la richiesta OID OID_SWITCH_NIC_DISCONNECT.
  
  Nota Se l'estensione denominata ReferenceSwitchNic per incrementare il contatore di riferimento del commutatore estendibile prima dell'emissione della OID_SWITCH_NIC_DISCONNECT, l'estensione può comunque inoltrare o originare richieste OID.
- Inoltrare o originare indicazioni sullo stato NDIS di NDIS_STATUS_SWITCH_NIC_STATUS da una scheda di rete sottostante per cui è stata rilasciata la richiesta OID OID_SWITCH_NIC_DISCONNECT.
  
  Nota Se l'estensione denominata ReferenceSwitchNic per incrementare il contatore di riferimento del commutatore estendibile prima dell'emissione della OID_SWITCH_NIC_DISCONNECT, l'estensione può comunque inoltrare o originare le indicazioni sullo stato di NDIS.
  
  Nota Se l'estensione precedentemente denominata ReferenceSwitchNic per incrementare il contatore di riferimento dell'commutatore estendibile, non deve sincronizzare le chiamate alle richieste OID o inoltrare richieste OID o NDIS con il relativo codice che gestisce le richieste OID estendibili di hyper-V. Dopo che l'estensione incrementa il contatore di riferimento, l'interfaccia del commutatore estendibile non emetterà una richiesta di set OID di OID_SWITCH_NIC_DELETE.
L'estensione deve sempre inoltrare questa richiesta impostata su estensioni sottostanti. L'estensione non deve completare la richiesta.
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 dell'interruttore estendibile genera una richiesta di set OID separata di OID_SWITCH_NIC_DISCONNECT. 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.

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

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