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