structure NDIS_NIC_SWITCH_VPORT_INFO (ntddndis.h)

Article
02/07/2025

La structure NDIS_NIC_SWITCH_VPORT_INFO spécifie la configuration d’un port virtuel (VPort) sur un commutateur de carte réseau de la carte réseau.

Syntaxe

typedef struct _NDIS_NIC_SWITCH_VPORT_INFO {
  NDIS_OBJECT_HEADER                         Header;
  NDIS_NIC_SWITCH_VPORT_ID                   VPortId;
  ULONG                                      Flags;
  NDIS_NIC_SWITCH_ID                         SwitchId;
  NDIS_VPORT_NAME                            VPortName;
  NDIS_SRIOV_FUNCTION_ID                     AttachedFunctionId;
  ULONG                                      NumQueuePairs;
  NDIS_NIC_SWITCH_VPORT_INTERRUPT_MODERATION InterruptModeration;
  NDIS_NIC_SWITCH_VPORT_STATE                VPortState;
  GROUP_AFFINITY                             ProcessorAffinity;
  ULONG                                      LookaheadSize;
  ULONG                                      NumFilters;
} NDIS_NIC_SWITCH_VPORT_INFO, *PNDIS_NIC_SWITCH_VPORT_INFO;

Membres

Header

Type, révision et taille de la structure NDIS_NIC_SWITCH_VPORT_INFO. 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_VPORT_INFO, le pilote doit définir le membre révision de d’en-tête sur la valeur suivante :

NDIS_NIC_SWITCH_VPORT_INFO_REVISION_1

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

Définissez le membre Size sur NDIS_SIZEOF_NIC_SWITCH_VPORT_INFO_REVISION_1.

VPortId

Valeur NDIS_NIC_SWITCH_VPORT_ID qui identifie de manière unique le port virtuel (VPort) sur la carte réseau.

Une valeur de NDIS_DEFAULT_VPORT_ID spécifie le VPort par défaut sur le commutateur. Le port virtuel par défaut est toujours attaché à la fonction physique PCI Express (PCIe) de la carte réseau.

Remarque Un VPort non défini avec la valeur VPortId spécifiée doit avoir été créée par le biais d’une requête de méthode OID de OID_NIC_SWITCH_CREATE_VPORT.

Flags

Valeur ULONG qui contient une OR au niveau du bit des indicateurs. Ce membre est réservé à NDIS.

SwitchId

Valeur NDIS_NIC_SWITCH_ID qui identifie de manière unique un commutateur de carte réseau créé sur la carte réseau. Le VPort identifié via le membre VPortId est créé sur le commutateur spécifié par le SwitchId membre.

L’identificateur de commutateur est un entier compris entre zéro et le nombre de commutateurs pris en charge par la carte réseau. La valeur de 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.

VPortName

Valeur NDIS_VPORT_NAME qui spécifie le nom du VPort créé sur le commutateur de carte réseau. Ce membre contient la description conviviale du VPort.

AttachedFunctionId

Valeur NDIS_SRIOV_FUNCTION_ID qui spécifie l’identificateur d’un VF ou du PF auquel le VPort est attaché.

Remarque Si cette valeur est NDIS_PF_FUNCTION_ID, la fenêtre virtuelle est attachée au PF.

NumQueuePairs

Valeur ULONG qui spécifie le nombre de paires de files d’attente configurées pour ce VPort.

Une paire de files d’attente se compose d’une file d’attente de transmission et d’une file d’attente de réception. Les paires de files d’attente associées au VPort par défaut sont configurées au moment de la création du commutateur via une requête de méthode OID de OID_NIC_SWITCH_CREATE_SWITCH. Une ou plusieurs paires de files d’attente sont configurées sur un VPort non défini par le biais d’une requête de méthode OID de OID_NIC_SWITCH_CREATE_VPORT.

InterruptModeration

Valeur NDIS_NIC_SWITCH_VPORT_INTERRUPT_MODERATION qui spécifie le paramètre de modération des interruptions du VPort.

VPortState

Valeur NDIS_NIC_SWITCH_VPORT_STATE qui spécifie l’état du VPort.

ProcessorAffinity

Valeur GROUP_AFFINITY qui spécifie le numéro de groupe et une bitmap des processeurs auxquels ce VPort peut être associé.

Ce membre est valide uniquement pour les ports virtuels attachés au PF. Ce champ n’est pas valide pour les ports virtuels non définis par défaut qui sont attachés à une machine virtuelle.

LookaheadSize

Ce membre est réservé à une utilisation ultérieure. Ce membre doit être défini sur zéro.

NumFilters

Valeur ULONG qui spécifie le nombre de filtres de réception qui ont été configurés sur la carte réseau.

Remarque À partir de NDIS 6.30, le pilote miniport doit conserver un compteur pour le nombre actuel de filtres de réception définis sur la carte réseau. Le pilote doit incrémenter le compteur chaque fois qu’un filtre de réception est défini par le biais d’une requête de jeu d’OID de OID_RECEIVE_FILTER_SET_FILTER. Le pilote doit également décrémenter le compteur chaque fois qu’un filtre de réception est effacé par le biais d’une demande de jeu d’OID de OID_RECEIVE_FILTER_CLEAR_FILTER.

Remarques

Une structure NDIS_NIC_SWITCH_VPORT_INFO contient des informations sur l’une des options suivantes :

Un VPort nondefault qui a été créé précédemment par le biais d’une requête de méthode OID de OID_NIC_SWITCH_CREATE_VPORT.
VPort par défaut attaché au PF. Le VPort par défaut existe toujours et ne peut pas être supprimé.

Une ou plusieurs structures NDIS_NIC_SWITCH_VPORT_INFO sont retournées par le biais de la structure NDIS_NIC_SWITCH_VPORT_INFO_ARRAY.

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