Mots clés INF standardisés pour SR-IOV

  • Article

Cette rubrique décrit les mots clés INF standardisés pour l’interface de virtualisation d’E/S racine unique (SR-IOV). Ces mots clés s’appliquent au fichier INF pour le pilote miniport de la fonction physique (PF) PCI Express (PCIe) d’une carte réseau SR-IOV.

Les mots clés INF SR-IOV sont décrits dans les sections suivantes :

Mots clés INF standardisés pour l’activation ou la désactivation de la prise en charge de SR-IOV

Mots clés INF standardisés pour la configuration du commutateur de carte réseau par défaut

Mots clés INF standardisés pour activer ou désactiver la prise en charge de SR-IOV

Les mots clés INF standardisés sont définis pour activer ou désactiver la prise en charge des fonctionnalités SR-IOV d’une carte réseau.

*SRIOV
Valeur qui indique si l’appareil a activé ou désactivé la fonctionnalité SR-IOV.

Une fois le pilote installé, les administrateurs peuvent mettre à jour la valeur *SRIOV mot clé dans la page de propriétés Avancés de la carte réseau. Pour plus d’informations sur les propriétés avancées, consultez Spécification des paramètres de configuration pour la page Propriétés avancées.

Note Le pilote miniport est automatiquement redémarré après qu’une modification a été apportée dans la page de propriétés Avancées de l’adaptateur.

*SriovPreferred
Valeur qui définit si les fonctionnalités SR-IOV doivent être activées au lieu des fonctionnalités de file d’attente de machines virtuelles (VMQ) ou de mise à l’échelle côté réception (RSS).

Il s’agit d’une valeur de mot clé masquée qui ne doit pas être spécifiée dans le fichier INF et qui n’est pas affichée dans la page de propriétés Avancé pour la carte réseau.

Pour plus d’informations sur l’interprétation des mots clés SR-IOV, VMQ et RSS, consultez Gestion des mots clés INF standardisés SR-IOV, VMQ et RSS.

Les mots clés INF standardisés SR-IOV sont des mots clés d’énumération et sont décrits dans le tableau suivant. Les colonnes de ce tableau décrivent les attributs suivants pour une énumération mot clé :

Nom de sous-clé
Nom du mot clé que vous devez spécifier dans le fichier INF. Ce nom apparaît également dans le Registre sous la clé NDI\params\ de la carte réseau.

ParamDesc
Texte d’affichage associé à l’mot clé SubkeyName.

Note Le fournisseur de matériel indépendant (IHV) peut définir n’importe quel texte descriptif pour subkeyName.

Valeur
Valeur entière d’énumération associée à chaque sous-cléName mot clé dans la liste.

EnumDesc
Texte d’affichage associé à chaque valeur qui apparaît dans le menu.

Nom de sous-clé ParamDesc Valeur EnumDesc
*SRIOV SR-IOV 0 Désactivé
1 (par défaut) activé
*SriovPreferred Les entrées ParamDesc et EnumDesc de cette sous-clé ne peuvent pas être utilisées dans des fichiers INF ou une interface utilisateur. 0 (Par défaut) Signaler les fonctionnalités RSS ou VMQ basées sur le mot clé *VmqOrRssPreferrence. Ne signalez pas les fonctionnalités SR-IOV. Pour plus d’informations sur l’mot clé *VmqOrRssPreferrence, consultez Mots clés INF standardisés pour VMQ.
1 Signaler les fonctionnalités SR-IOV.

Pour plus d’informations sur les mots clés INF standardisés, consultez Mots clés INF standardisés pour les appareils réseau.

Mots clés INF standardisés pour la configuration du commutateur de carte réseau par défaut

À 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 et est référencé par l’identificateur de NDIS_DEFAULT_SWITCH_ID.

Le fichier INF du pilote pf miniport doit spécifier la configuration du commutateur de carte réseau par défaut sur la carte réseau SR-IOV. Cela permet au programme d’installation réseau de copier les informations de configuration de commutateur par défaut de l’INF vers la configuration du registre miniport sous la sous-clé du commutateur par défaut (NDI\params\NicSwitches\0).

Ces mots clés ne sont pas affichés dans la page de propriétés Avancés de la carte réseau et ne peuvent pas être configurés par l’utilisateur. Ces mots clés sont spécifiés à l’aide de la directive AddReg dans la section DDInstall du fichier INF. Chaque mot clé est spécifié par une directive AddReg distincte.

Le tableau suivant décrit les mots clés INF pour la configuration de commutateur de carte réseau par défaut de la carte réseau SR-IOV. Les colonnes de ce tableau décrivent les attributs suivants pour ces mots clés :

Nom de sous-clé
Nom du mot clé que vous devez spécifier dans le fichier INF. Ce nom apparaît également dans le Registre sous la clé NDI\params\NicSwitches\0 de la carte réseau.

Valeur
Valeur associée à l’mot clé SubkeyName.

Type de données
Type de la valeur de données.

Nom de sous-clé Valeur Type de données Notes
*Drapeaux 0 REG_DWORD Cette valeur doit être affectée au mot clé.
*SwitchType 1 REG_DWORD Cette valeur doit être affectée au mot clé.
*SwitchId 0 REG_DWORD Cette valeur doit être affectée au mot clé.
*SwitchName « Commutateur par défaut » REG_SZ Cette valeur doit être affectée au mot clé.
*NumVFs (0-n), REG_DWORD n est le nombre maximal de fonctions virtuelles PCIe prises en charge par la carte réseau SR-IOV. Note Cette clé de Registre définit le nombre maximal de machines virtuelles que la carte réseau prend en charge. Lorsque le pilote miniport appelle NdisMSetMiniportAttributes, il peut publier une valeur inférieure à cette valeur en fonction des ressources matérielles disponibles sur la carte réseau. Pour plus d’informations, consultez Détermination des fonctionnalités de commutateur de carte réseau.

Voici un exemple de directives AddReg pour la configuration de commutateur de carte réseau par défaut d’une carte réseau SR-IOV :

HKR, NicSwitches\0, *SwitchId,   0x00010001, 0
HKR, NicSwitches\0, *SwitchName, 0x00000000, “Default Switch”

Pour plus d’informations sur la syntaxe de la directive AddReg , consultez Directive AddReg INF.

Pour plus d’informations sur le commutateur de carte réseau par défaut, consultez Commutateurs de carte réseau.