structure NDIS_NIC_SWITCH_PARAMETERS (ntddndis.h)

Article
02/07/2025

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 de l'd’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 révision 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 taille sur NDIS_SIZEOF_NIC_SWITCH_PARAMETERS_REVISION_1.

Flags

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

NDIS_NIC_SWITCH_PARAMETERS_SWITCH_NAME_CHANGED

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

Remarque Cet indicateur n’est valide que lorsque cette structure est utilisée dans une requête de jeu d’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.

Remarque à partir de Windows Server 2012, Windows prend uniquement en charge un type de commutateur de 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 sur 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.

Remarque à partir de Windows Server 2012, l’interface 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 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.

Remarque Avant qu’une machine virtuelle puisse être attachée à une partition enfant Hyper-V, les ressources doivent être allouées pour elle 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 requêtes de méthode OID de OID_NIC_SWITCH_CREATE_SWITCH et de OID_NIC_SWITCH_PARAMETERS. Ces demandes 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).