Définition des paramètres d’un commutateur de carte réseau

  • Article

Un pilote de dépassement peut modifier les paramètres d’un commutateur de carte réseau qui a été créé sur une carte réseau qui prend en charge la virtualisation d’E/S racine unique (SR-IOV). Le pilote émet une demande d’ensemble d’identificateur d’objet (OID) de OID_NIC_SWITCH_PARAMETERS pour modifier ces paramètres. Seul le pilote miniport pour la fonction physique (PF) PCI Express (PCIe) de l’adaptateur SR-IOV gère cette demande de jeu d’OID.

Avant que le pilote overlying n’envoie cette demande de jeu d’OID, il doit initialiser une structure de NDIS_NIC_SWITCH_PARAMETERS avec les paramètres à modifier sur le commutateur de carte réseau. Le pilote initialise ensuite une structure NDIS_OID_REQUEST pour la requête OID et définit le membre InformationBuffer sur un pointeur de la structure NDIS_NIC_SWITCH_PARAMETERS .

Seul un sous-ensemble limité de paramètres de configuration pour un commutateur de carte réseau peut être modifié. Le pilote overlying spécifie le paramètre à modifier en définissant les membres suivants de la structure NDIS_NIC_SWITCH_PARAMETERS :

  • Le membre SwitchId est défini sur l’identificateur du commutateur de carte réseau dont les paramètres seront modifiés.

    Note À compter de Windows Server 2012, l’interface SR-IOV ne prend en charge qu’un seul commutateur de carte réseau sur la carte réseau. Ce commutateur est appelé commutateur de carte réseau par défaut. Le membre SwitchId doit être défini sur NDIS_DEFAULT_SWITCH_ID.

  • Les indicateurs NDIS_NIC_SWITCH_PARAMETERS_Xxx_CHANGED appropriés sont définis dans le membre Indicateurs . Les membres de la structure NDIS_NIC_SWITCH_PARAMETERS ne peuvent être modifiés que si un indicateur NDIS_NIC_SWITCH_PARAMETERS_Xxx_CHANGED correspondant est défini dans Ntddndis.h.

  • Les membres de la structure NDIS_NIC_SWITCH_PARAMETERS , qui correspondent aux indicateurs NDIS_NIC_SWITCH_PARAMETERS_Xxx_CHANGED définis dans le membre Indicateurs , sont définis avec les paramètres de configuration du commutateur de carte réseau qui doivent être modifiés.

    Note À compter de Windows Server 2012, seul le membre SwitchName de la structure NDIS_NIC_SWITCH_PARAMETERS peut être modifié par le biais d’une requête de jeu d’OID de OID_NIC_SWITCH_PARAMETERS.

Le pilote pf miniport doit suivre ces instructions lorsqu’il reçoit la demande de jeu d’OID de OID_NIC_SWITCH_PARAMETERS

  • Si le pilote PF miniport peut appliquer les modifications sans nécessiter de réinitialisation de la carte réseau, le pilote applique les modifications au matériel et termine la requête OID avec NDIS_STATUS_SUCCESS.

    Si ce code status est retourné, NDIS met à jour les informations de configuration du commutateur de carte réseau dans le Registre.

  • Si le pilote PF miniport nécessite une réinitialisation de la carte réseau pour appliquer les modifications, le pilote termine la requête OID avec NDIS_STATUS_REINIT_REQUIRED.

    Si ce code status est retourné, NDIS met également à jour les informations de configuration du commutateur de carte réseau dans le Registre. Toutefois, le pilote qui a émis la demande de jeu d’OID doit réinitialiser la carte réseau afin que les modifications puissent prendre effet.

    Note Les pilotes pf miniport qui prennent en charge la création et la configuration de cartes réseau statiques peuvent retourner NDIS_STATUS_REINIT_REQUIRED pour s’assurer que l’adaptateur est réinitialisé pour que les nouveaux paramètres prennent effet.

  • Si le pilote pf miniport ne peut pas appliquer les modifications demandées dans l’OID, il doit faire échouer l’OID et retourner le code NDIS_STATUS_Xxx approprié.

    Dans ce cas, NDIS ne met pas à jour les informations de configuration du commutateur de carte réseau dans le Registre.