Partager via


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)

Voir aussi


DereferenceSwitchNic

NDIS_OID_REQUEST

NDIS_SWITCH_NIC_PARAMETERS

OID_SWITCH_NIC_DISCONNECT

OID_SWITCH_PORT_ARRAY

ReferenceSwitchNic