structure NDIS_NIC_SWITCH_PARAMETERS (ntddndis.h)

Article
02/26/2024

La structure NDIS_NIC_SWITCH_PARAMETERS spécifie les paramètres de configuration d’un commutateur de carte réseau sur la carte réseau.

Syntaxe

typedef struct _NDIS_NIC_SWITCH_PARAMETERS {
  NDIS_OBJECT_HEADER           Header;
  ULONG                        Flags;
  NDIS_NIC_SWITCH_TYPE         SwitchType;
  NDIS_NIC_SWITCH_ID           SwitchId;
  NDIS_NIC_SWITCH_FRIENDLYNAME SwitchFriendlyName;
  ULONG                        NumVFs;
  ULONG                        NdisReserved1;
  ULONG                        NdisReserved2;
  ULONG                        NdisReserved3;
  ULONG                        NumQueuePairsForDefaultVPort;
} NDIS_NIC_SWITCH_PARAMETERS, *PNDIS_NIC_SWITCH_PARAMETERS;

Membres

Header

Type, révision et taille de la structure NDIS_NIC_SWITCH_PARAMETERS . Ce membre est mis en forme en tant que structure NDIS_OBJECT_HEADER .

Le pilote miniport doit définir le membre Type de l’en-tête sur NDIS_OBJECT_TYPE_DEFAULT. Pour spécifier la version de la structure NDIS_NIC_SWITCH_PARAMETERS , le pilote doit définir le membre Revision de Header sur la valeur suivante :

NDIS_NIC_SWITCH_PARAMETERS_REVISION_1

Version d’origine pour NDIS 6.30 et versions ultérieures.

Définissez le membre Size sur NDIS_SIZEOF_NIC_SWITCH_PARAMETERS_REVISION_1.

Flags

Valeur ULONG qui contient un OR au niveau du bit d’indicateurs. Les indicateurs suivants sont définis pour ce membre.

NDIS_NIC_SWITCH_PARAMETERS_SWITCH_NAME_CHANGED

Cet indicateur spécifie que le champ qui a été mis à jour dans la structure NDIS_NIC_SWITCH_PARAMETERS est le membre SwitchName .

Note Cet indicateur n’est valide que lorsque cette structure est utilisée dans une demande de jeu OID de OID_NIC_SWITCH_PARAMETERS.

SwitchType

Valeur d’énumération NDIS_NIC_SWITCH_TYPE qui spécifie le type du commutateur de carte réseau.

Note À compter de Windows Server 2012, Windows prend uniquement en charge un type de commutateur NdisNicSwitchTypeExternal. Un commutateur externe spécifie que les ports connectés à ce type de commutateur peuvent accéder au réseau externe via le port physique de la carte réseau. Le port virtuel par défaut (VPort) sur le commutateur externe fournit une connectivité réseau externe à la pile de virtualisation qui s’exécute dans le système d’exploitation de gestion de la partition parente Hyper-V.

SwitchId

Valeur NDIS_NIC_SWITCH_ID qui contient un identificateur de commutateur. L’identificateur de commutateur est un entier compris entre zéro et le nombre de commutateurs pris en charge par la carte réseau. Une valeur NDIS_DEFAULT_SWITCH_ID indique le commutateur de carte réseau par défaut.

Note À compter de Windows Server 2012, l’interface de virtualisation d’E/S racine unique (SR-IOV) prend uniquement en charge le commutateur de carte réseau par défaut sur la carte réseau. La valeur de ce membre doit être définie sur NDIS_DEFAULT_SWITCH_ID.

SwitchFriendlyName

Valeur NDIS_NIC_SWITCH_FRIENDLYNAME qui contient une description du commutateur.

NumVFs

Valeur ULONG qui spécifie le nombre de fonctions virtuelles (VF) PCI Express (PCIe) activées sur la carte réseau. Les machines virtuelles sont activées sur l’adaptateur lorsque la virtualisation est activée via un appel à NdisMEnableVirtualization.

Note Pour qu’une machine virtuelle virtuelle puisse être attachée à une partition enfant Hyper-V, des ressources doivent être allouées pour celle-ci via une demande de méthode OID de OID_NIC_SWITCH_ALLOCATE_VF.

NdisReserved1

Réservé à NDIS.

NdisReserved2

Réservé à NDIS.

NdisReserved3

Réservé à NDIS.

NumQueuePairsForDefaultVPort

Remarques

La structure NDIS_NIC_SWITCH_PARAMETERS est utilisée dans les demandes de méthode OID de OID_NIC_SWITCH_CREATE_SWITCH et de OID_NIC_SWITCH_PARAMETERS. Ces requêtes OID définissent ou interrogent les paramètres de configuration d’un commutateur de carte réseau.

Pour plus d’informations sur l’interface SR-IOV, consultez Vue d’ensemble de la virtualisation d’E/S racine unique (SR-IOV).