OID_SWITCH_NIC_UPDATED

Articolo
06/15/2023

Il bordo del protocollo del commutatore estendibile Hyper-V invia una richiesta di set di identificatori di oggetto (OID) di OID_SWITCH_NIC_UPDATED allo stack di driver del commutatore estendibile. Questa richiesta OID invia una notifica alle estensioni del commutatore estendibili sottostanti sull'aggiornamento dei parametri di una scheda di rete. L'OID verrà emesso solo per le schede di interfaccia di rete che sono già state connesse e non hanno ancora avviato il processo di disconnessione. Queste modifiche alla configurazione di runtime possono includere NicFriendlyName, NetCfgInstanceId, MTU, NumaNodeId, PermanentMacAddress, VMMacAddress, CurrentMacAddress e VFAssigned.

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 aggiornamento. 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 eseguita la notifica di aggiornamento. 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 per la gestione delle richieste del set OID di OID_SWITCH_NIC_UPDATED:

L'estensione non deve modificare la struttura NDIS_SWITCH_NIC_PARAMETERS associata alla richiesta OID.
L'estensione deve sempre inoltrare questa richiesta impostata dall'OID alle estensioni sottostanti. L'estensione non deve completare la richiesta.
L'estensione non deve eseguire richieste del proprio set OID di OID_SWITCH_NIC_UPDATED.

Codici di stato restituiti

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