OID_SWITCH_NIC_UPDATED

Article
06/15/2023

Le bord du protocole du commutateur extensible Hyper-V émet une demande de jeu d’identificateur d’objet (OID) de OID_SWITCH_NIC_UPDATED à la pile de pilotes de commutateur extensible. Cette demande OID informe les extensions de commutateur extensible sous-jacentes de la mise à jour des paramètres d’une carte réseau. L’OID sera émis uniquement pour les cartes réseau qui ont déjà été connectées et qui n’ont pas encore commencé le processus de déconnexion. Ces modifications de configuration d’exécution peuvent inclure NicFriendlyName, NetCfgInstanceId, MTU, NumaNodeId, PermanentMacAddress, VMMacAddress, CurrentMacAddress et VFAssigned.

Le membre InformationBuffer de la structure NDIS_OID_REQUEST contient un pointeur vers une structure NDIS_SWITCH_NIC_PARAMETERS .

Notes

Le membre PortId de la structure NDIS_SWITCH_NIC_PARAMETERS spécifie le port pour lequel la notification de mise à jour est effectuée. L’extension de commutateur extensible peut obtenir les informations de paramètre pour ce port et d’autres ports sur le commutateur extensible en émettant des requêtes OID de OID_SWITCH_PORT_ARRAY.

Le membre Index de la structure NDIS_SWITCH_NIC_PARAMETERS spécifie l’index d’une carte réseau pour laquelle la notification de mise à jour est effectuée. La carte réseau avec la valeur d’index spécifiée est connectée au port de commutateur extensible spécifié par le membre PortId . Pour plus d’informations sur ces valeurs d’index, consultez Valeurs d’index de carte réseau.

L’extension doit suivre ces instructions pour gérer les demandes de jeu d’OID de OID_SWITCH_NIC_UPDATED :

L’extension ne doit pas modifier la structure NDIS_SWITCH_NIC_PARAMETERS associée à la requête OID.
L’extension doit toujours transférer cette demande de jeu d’OID aux extensions sous-jacentes. L’extension ne doit pas terminer la demande.
L’extension ne doit pas émettre ses propres demandes de jeu d’OID de OID_SWITCH_NIC_UPDATED.

Codes d’état de retour

Le bord miniport sous-jacent du commutateur extensible termine la requête de requête OID de OID_SWITCH_NIC_UPDATED et retourne le code status suivant.