OID_SWITCH_NIC_DISCONNECT
Il bordo del protocollo del commutatore estendibile Hyper-V emette una richiesta di set di identificatori di oggetto (OID) di OID_SWITCH_NIC_DISCONNECT per notificare alle estensioni del commutatore estendibili sottostanti che una connessione tra una porta del commutatore estendibile e una scheda di rete viene interrotta. Dopo l'interruzione completa della connessione, il bordo del protocollo dell'opzione 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.
Osservazioni
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 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.
L'estensione deve seguire queste linee guida quando gestisce le richieste di set OID di OID_SWITCH_NIC_DISCONNECT:
L'estensione non deve modificare la struttura NDIS_SWITCH_NIC_PARAMETERS associata alla richiesta OID.
La richiesta OID_SWITCH_NIC_DISCONNECT notifica solo all'estensione che la connessione del commutatore estendibile viene detronata 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 verso la connessione della scheda di rete sulla porta del commutatore estendibile per cui è stata eseguita la richiesta OID OID_SWITCH_NIC_DISCONNECT.
Chiamare ReferenceSwitchNic per incrementare il contatore dei riferimenti 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 eseguita la richiesta OID OID_SWITCH_NIC_DISCONNECT.
Nota Se l'estensione denominata ReferenceSwitchNic per incrementare il contatore di riferimento dell'opzione estendibile prima dell'emissione del OID_SWITCH_NIC_DISCONNECT, l'estensione può comunque inoltrare o originare richieste OID.
Inoltrare o originare indicazioni di stato NDIS di NDIS_STATUS_SWITCH_NIC_STATUS da una scheda di rete sottostante per cui è stata eseguita la richiesta OID OID_SWITCH_NIC_DISCONNECT.
Nota Se l'estensione denominata ReferenceSwitchNic per incrementare il contatore di riferimento dell'opzione estendibile prima dell'emissione del OID_SWITCH_NIC_DISCONNECT, l'estensione può comunque inoltrare o originare indicazioni di stato NDIS.
Nota Se l'estensione precedentemente chiamata ReferenceSwitchNic per incrementare il contatore di riferimento dell'opzione estendibile, non è necessario sincronizzare le chiamate a richieste OID o inoltrare richieste OID o NDIS con il relativo codice che gestisce Hyper-V richieste OID del commutatore estendibile. Dopo che l'estensione incrementa il contatore di riferimento, l'interfaccia dell'opzione estendibile non emetterà una richiesta di set OID di OID_SWITCH_NIC_DELETE.
L'estensione deve sempre inoltrare questa richiesta di impostazione dell'OID alle estensioni sottostanti. L'estensione non deve completare la richiesta.
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_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 le schede di rete fisiche alla scheda di rete esterna, vedere Tipi di configurazioni delle schede di rete fisiche.
Nota L'estensione non deve inviare richieste di set OID personalizzate di OID_SWITCH_NIC_DISCONNECT.
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_DISCONNECT e restituisce il codice di stato seguente.
| Codice di stato | Descrizione |
|---|---|
NDIS_STATUS_SUCCESS |
Richiesta OID completata. |
Fabbisogno
Versione |
Supportato in NDIS 6.30 e versioni successive. |
Intestazione |
Ntddndis.h (include Ndis.h) |