Partager via


structure NDIS_NIC_SWITCH_VPORT_PARAMETERS (ntddndis.h)

La structure NDIS_NIC_SWITCH_VPORT_PARAMETERS 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_PARAMETERS {
  NDIS_OBJECT_HEADER                         Header;
  ULONG                                      Flags;
  NDIS_NIC_SWITCH_ID                         SwitchId;
  NDIS_NIC_SWITCH_VPORT_ID                   VPortId;
  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;
  NDIS_NDK_PARAMETERS                        NdkParams;
  NDIS_QOS_SQ_ID                             QosSqId;
} NDIS_NIC_SWITCH_VPORT_PARAMETERS, *PNDIS_NIC_SWITCH_VPORT_PARAMETERS;

Membres

Header

Type, révision et taille de la structure NDIS_NIC_SWITCH_VPORT_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 indiquer la version de la structure NDIS_NIC_SWITCH_VPORT_PARAMETERS , définissez le membre Revision de Header sur l’une des valeurs suivantes :

NDIS_NIC_SWITCH_VPORT_PARAMETERS_REVISION_2

Ajout du champ QosSqId pour NDIS 6.50.

Définissez le membre Size sur NDIS_SIZEOF_NIC_SWITCH_VPORT_PARAMETERS_REVISION_2.

NDIS_NIC_SWITCH_VPORT_PARAMETERS_REVISION_1

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

Définissez le membre Size sur NDIS_SIZEOF_NIC_SWITCH_VPORT_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_VPORT_PARAMS_LOOKAHEAD_SPLIT_ENABLED

Cet indicateur est réservé pour une utilisation future. Les pilotes miniport doivent ignorer cet indicateur.

NDIS_NIC_SWITCH_VPORT_PARAMS_FLAGS_CHANGED

Cet indicateur spécifie que le membre Flags a été mis à jour après la création du VPort. Ces indicateurs peuvent être activés ou désactivés une fois le VPort créé à l’aide d’une requête de jeu OID de OID_NIC_SWITCH_VPORT_PARAMETERS.

Notes

Cet indicateur n’est valide que lorsque cette structure est utilisée dans les demandes de jeu OID de OID_NIC_SWITCH_VPORT_PARAMETERS.

NDIS_NIC_SWITCH_VPORT_PARAMS_NAME_CHANGED

Cet indicateur spécifie que le membre VPortName a été mis à jour après la création du VPort. Ce membre peut être mis à jour à l’aide d’une demande d’ensemble OID de OID_NIC_SWITCH_VPORT_PARAMETERS.

Notes

Cet indicateur n’est valide que lorsque cette structure est utilisée dans les demandes de jeu OID de OID_NIC_SWITCH_VPORT_PARAMETERS.

NDIS_NIC_SWITCH_VPORT_PARAMS_INT_MOD_CHANGED

Cet indicateur spécifie que le membre InterruptModeration a été mis à jour après la création du VPort. Ce membre peut être mis à jour à l’aide d’une demande d’ensemble OID de OID_NIC_SWITCH_VPORT_PARAMETERS.

Notes

Cet indicateur n’est valide que lorsque cette structure est utilisée dans les demandes de jeu OID de OID_NIC_SWITCH_VPORT_PARAMETERS.

NDIS_NIC_SWITCH_VPORT_PARAMS_STATE_CHANGED

Cet indicateur spécifie que le membre VPortState a été mis à jour après la création du VPort. Ce membre peut être mis à jour à l’aide d’une demande d’ensemble OID de OID_NIC_SWITCH_VPORT_PARAMETERS.

Notes

Cet indicateur n’est valide que lorsque cette structure est utilisée dans les demandes de jeu OID de OID_NIC_SWITCH_VPORT_PARAMETERS.

NDIS_NIC_SWITCH_VPORT_PARAMS_PROCESSOR_AFFINITY_CHANGED

Cet indicateur spécifie que le membre ProcessoryAffinity a été mis à jour après la création du VPort. L’affinité processeur d’un VPort ne peut être mise à jour que si le VPort est attaché au pf sur la carte réseau. Le membre ProcessoryAffinity peut être mis à jour à l’aide d’une demande de jeu OID de OID_NIC_SWITCH_VPORT_PARAMETERS.

Notes

Cet indicateur n’est valide que lorsque cette structure est utilisée dans les demandes de jeu OID de OID_NIC_SWITCH_VPORT_PARAMETERS.

NDIS_NIC_SWITCH_VPORT_PARAMS_NUM_QUEUE_PAIRS_CHANGED

Cet indicateur spécifie que le membre NumQueuePairs a été mis à jour après la création du VPort. Lorsque les files d’attente multiples de machines virtuelles (VMMQ) sont activées, le nombre de files d’attente pour les ports Vport par défaut et non par défaut peut être mis à jour. Le membre NumQueuePairs peut être mis à jour à l’aide d’une demande de jeu OID de OID_NIC_SWITCH_VPORT_PARAMETERS.

Note Cet indicateur n’est valide que lorsque cette structure est utilisée dans les demandes de jeu OID de OID_NIC_SWITCH_VPORT_PARAMETERS.
 

SwitchId

Valeur NDIS_NIC_SWITCH_ID qui spécifie l’identificateur du commutateur sur lequel le VPort doit être créé.

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.

Notes

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

VPortId

Valeur NDIS_NIC_SWITCH_VPORT_ID qui spécifie l’identificateur d’un VPort sur la carte réseau. La valeur est allouée par NDIS et est unique sur la carte réseau.

La valeur VPortId est comprise entre zéro et (NumVPorts - 1), où NumVPorts correspond au nombre de VPorts que le pilote miniport a configurés sur la carte réseau. Le pilote spécifie ce nombre dans le membre NumVPorts de la structure NDIS_NIC_SWITCH_INFO . Le pilote retourne cette structure par le biais d’une requête OID de OID_NIC_SWITCH_ENUM_SWITCHES.

Notes

Un identificateur VPort de NDIS_DEFAULT_VPORT_ID est réservé au VPort par défaut attaché au pf sur le commutateur de carte réseau par défaut.

VPortName

Valeur NDIS_VPORT_NAME qui spécifie le nom du VPort. Ce membre contient une description conviviale du VPort.

AttachedFunctionId

Une valeur NDIS_SRIOV_FUNCTION_ID qui spécifie l’ID de la fonction physique (PF) ou de la fonction virtuelle (VF) à laquelle le VPort est attaché. La valeur NDIS_PF_FUNCTION_ID spécifie que le VPort est attaché au PF. Si la valeur est un identificateur VF valide, le VPort est attaché à la VF.

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 actuel du VPort.

ProcessorAffinity

Valeur GROUP_AFFINITY qui spécifie le numéro de groupe et une bitmap des processeurs auxquels ce VPort est associé. Ce champ est valide uniquement pour les VPorts qui sont attachés au pf.

Notes

Pour les VPorts PF non par défaut, une valeur GROUP_AFFINITY qui spécifie un seul processeur doit être spécifiée lors de la création du VPort. Les VPorts sont créés via une demande de méthode OID de OID_NIC_SWITCH_CREATE_VPORT.

L’affinité processeur associée au VPort non par défaut attaché au pf peut être modifiée après la création de VPort. L’affinité processeur associée au VPort par défaut peut également être modifiée à l’aide d’une demande de jeu OID de OID_NIC_SWITCH_VPORT_PARAMETERS.

LookaheadSize

Ce membre est réservé pour un usage ultérieur. Ce membre doit être défini sur zéro.

NdkParams

QosSqId

Associe un vPort à une file d’attente du planificateur (SQ). Définissez ce champ sur un ID SQ valide pour associer le vPort à un sq. Définissez ce champ sur zéro s’il n’existe aucune association SQ. Pour plus d’informations sur NDIS_QOS_SQ_ID, consultez OID_QOS_OFFLOAD_CREATE_SQ.

Remarques

Cette structure est utilisée dans les requêtes OID de OID_NIC_SWITCH_CREATE_VPORT et OID_NIC_SWITCH_VPORT_PARAMETERS.

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

Configuration requise

Condition requise Valeur
Client minimal pris en charge Pris en charge dans NDIS 6.30 et versions ultérieures.
Serveur minimal pris en charge Windows Server 2022
En-tête ntddndis.h (include Ndis.h)

Voir aussi

NDIS_NIC_SWITCH_INFO

NDIS_NIC_SWITCH_VF_INFO

NDIS_OBJECT_HEADER

OID_NIC_SWITCH_CREATE_VPORT

OID_NIC_SWITCH_ENUM_SWITCHES

OID_NIC_SWITCH_VPORT_PARAMETERS