structure NDIS_NIC_SWITCH_VPORT_INFO (ntddndis.h)

Article
08/07/2023

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 l’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 l’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

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

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

Note Un VPort non par défaut avec la valeur VPortId spécifiée doit avoir déjà été créé via une demande de méthode OID de OID_NIC_SWITCH_CREATE_VPORT.

Flags

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

SwitchId

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

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 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.

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é.

Note Si cette valeur est NDIS_PF_FUNCTION_ID, le VPort est attaché 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 demande 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 par défaut via une demande 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 d’interruption 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 VPorts attachés au PF. Ce champ n’est pas valide pour les VPorts non par défaut qui sont attachés à une VF.

LookaheadSize

Ce membre est réservé pour un usage ultérieur. 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.

Note À compter 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 via une demande de jeu 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é via une demande de jeu OID de OID_RECEIVE_FILTER_CLEAR_FILTER.

Remarques

Une structure NDIS_NIC_SWITCH_VPORT_INFO contient des informations sur l’un des éléments suivants :

VPort non par défaut qui a été créé précédemment via une demande 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).