structure NDIS_NIC_SWITCH_VF_PARAMETERS (ntddndis.h)

Article
02/27/2024

Le NDIS_NIC_SWITCH_VF_PARAMETERS spécifie les paramètres de ressource d’une fonction virtuelle (VF) PCI Express (PCIe) sur une carte réseau.

Syntaxe

typedef struct _NDIS_NIC_SWITCH_VF_PARAMETERS {
  NDIS_OBJECT_HEADER     Header;
  ULONG                  Flags;
  NDIS_NIC_SWITCH_ID     SwitchId;
  NDIS_VM_NAME           VMName;
  NDIS_VM_FRIENDLYNAME   VMFriendlyName;
  NDIS_SWITCH_NIC_NAME   NicName;
  USHORT                 MacAddressLength;
  UCHAR                  PermanentMacAddress[NDIS_MAX_PHYS_ADDRESS_LENGTH];
  UCHAR                  CurrentMacAddress[NDIS_MAX_PHYS_ADDRESS_LENGTH];
  NDIS_SRIOV_FUNCTION_ID VFId;
  NDIS_VF_RID            RequestorId;
} NDIS_NIC_SWITCH_VF_PARAMETERS, *PNDIS_NIC_SWITCH_VF_PARAMETERS;

Membres

Header

Type, révision et taille de la structure NDIS_NIC_SWITCH_VF_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_VF_PARAMETERS , le pilote doit définir le membre Revision de Header sur la valeur suivante :

NDIS_NIC_SWITCH_VF_PARAMETERS_REVISION_1

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

Définissez le membre Size sur NDIS_SIZEOF_NIC_SWITCH_VF_PARAMETERS_REVISION_1.

Flags

Valeur ULONG qui contient un OR au niveau du bit d’indicateurs. Ce membre est réservé à NDIS.

SwitchId

Valeur NDIS_NIC_SWITCH_ID qui spécifie un identificateur de commutateur. Cette valeur identifie le commutateur de carte réseau sur lequel la VF est allouée.

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.

VMName

Valeur NDIS_VM_NAME qui spécifie le nom interne de la partition enfant Hyper-V attachée à la VF.

Note La partition enfant Hyper-V est également appelée machine virtuelle.

VMFriendlyName

Valeur NDIS_VM_FRIENDLYNAME qui spécifie le nom externe de la partition enfant Hyper-V attachée à la VF. Ce membre contient la description conviviale de la partition.

NicName

Valeur NDIS_SWITCH_NIC_NAME qui spécifie le nom de la carte réseau de la machine virtuelle. Ce membre contient la description conviviale de la carte réseau.

La carte réseau de machine virtuelle est un appareil virtuel exposé dans le système d’exploitation invité qui s’exécute dans une partition enfant Hyper-V. La carte réseau de machine virtuelle s’associe à la carte réseau VF pour fournir le chemin des données VF basée sur le matériel via l’interface SR-IOV.

Pour plus d’informations sur le chemin des données VF, consultez Chemin des données VF SR-IOV.

MacAddressLength

Valeur USHORT qui spécifie la longueur des membres PermanentMacAddress et CurrentMacAddress .

PermanentMacAddress[NDIS_MAX_PHYS_ADDRESS_LENGTH]

Adresse MAC permanente de la VF. Il s’agit de l’adresse MAC permanente de la carte réseau VF exposée dans le système d’exploitation invité.

CurrentMacAddress[NDIS_MAX_PHYS_ADDRESS_LENGTH]

Adresse MAC actuelle de la VF. Il s’agit de l’adresse MAC actuelle pour la carte réseau VF exposée dans le système d’exploitation invité.

VFId

Valeur NDIS_SRIOV_FUNCTION_ID qui spécifie l’identificateur unique de la VF sur la carte réseau.

RequestorId

Une NDIS_VF_RID qui spécifie l’ID de demandeur (RID) PCI Express (PCIe) de la VF.

Remarques

La structure NDIS_NIC_SWITCH_VF_PARAMETERS est utilisée dans les demandes de méthode OID de OID_NIC_SWITCH_ALLOCATE_VF et de OID_NIC_SWITCH_VF_PARAMETERS.

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