OID_SWITCH_NIC_UPDATED
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 avertit les extensions de commutateur extensible sous-jacentes sur 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 n’ont pas encore commencé le processus de déconnexion. Ces modifications de configuration au moment de l’exécution peuvent inclure NicFriendlyName, NetCfgInstanceId, MTU, NumaNodeId, PermanentMacAddress, VMMacAddress, CurrentMacAddresset VFAssigned.
Le membre InformationBuffer de la structure NDIS_OID_REQUEST contient un pointeur vers une structure NDIS_SWITCH_NIC_PARAMETERS.
Remarques
Le portId membre 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 de ce commutateur et d’autres ports sur le commutateur extensible en émettant des requêtes de requête OID de OID_SWITCH_PORT_ARRAY.
L’index membre 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 Index spécifiée est connectée au port de commutateur extensible spécifié par le PortId membre. 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 requête.
- L’extension ne doit pas émettre ses propres requêtes 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 d’état suivant.
Code d’état | Description |
---|---|
NDIS_STATUS_SUCCESS |
La requête OID s’est terminée avec succès. |
Exigences
Version |
Prise en charge dans NDIS 6.30 et versions ultérieures. |
En-tête |
Ntddndis.h (include Ndis.h) |