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 de l'd’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 taille 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 une OR au niveau du bit des indicateurs. Les indicateurs suivants sont définis pour ce membre.
NDIS_NIC_SWITCH_VPORT_PARAMS_LOOKAHEAD_SPLIT_ENABLED
Cet indicateur est réservé à une utilisation ultérieure. Les pilotes miniport doivent ignorer cet indicateur.
NDIS_NIC_SWITCH_VPORT_PARAMS_FLAGS_CHANGED
Cet indicateur spécifie que les indicateurs membre ont été mis à jour après la création du VPort. Ces indicateurs peuvent être activés ou désactivés une fois que le VPort a été créé à l’aide d’une demande de jeu d’OID de OID_NIC_SWITCH_VPORT_PARAMETERS.
Note
Cet indicateur est valide uniquement lorsque cette structure est utilisée dans les requêtes définies par 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 requête de jeu d’OID de OID_NIC_SWITCH_VPORT_PARAMETERS.
Note
Cet indicateur est valide uniquement lorsque cette structure est utilisée dans les requêtes définies par 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 de la fenêtre virtuelle. Ce membre peut être mis à jour à l’aide d’une requête de jeu d’OID de OID_NIC_SWITCH_VPORT_PARAMETERS.
Note
Cet indicateur est valide uniquement lorsque cette structure est utilisée dans les requêtes définies par 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 requête de jeu d’OID de OID_NIC_SWITCH_VPORT_PARAMETERS.
Note
Cet indicateur est valide uniquement lorsque cette structure est utilisée dans les requêtes définies par 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 de la fenêtre virtuelle. 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 requête de jeu d’OID de OID_NIC_SWITCH_VPORT_PARAMETERS.
Note
Cet indicateur est valide uniquement lorsque cette structure est utilisée dans les requêtes définies par 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 machine virtuelle plusieurs files d’attente (VMMQ) est activée, le nombre de files d’attente pour les ports virtuels par défaut et non par défaut peut être mis à jour. Le membre NumQueuePairs peut être mis à jour à l’aide d’une requête de jeu d’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.
Note
À compter 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.
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 se trouve dans la plage comprise entre zéro et (NumVPorts - 1), où NumVPorts correspond au nombre de ports virtuels que le pilote miniport a configurés sur la carte réseau. Le pilote spécifie ce nombre dans le NumVPorts membre de la structure NDIS_NIC_SWITCH_INFO. Le pilote retourne cette structure via une requête de requête OID de OID_NIC_SWITCH_ENUM_SWITCHES.
Note
Un identificateur de 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
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é. Une valeur de 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é au 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 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 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 ports virtuels attachés au PF.
Note
Pour les ports virtuels PF non définis 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 ports virtuels sont créés via une requête de méthode OID de OID_NIC_SWITCH_CREATE_VPORT.
L’affinité du processeur associée au VPort nondefault attaché au PF peut être modifiée après la création de VPort. L’affinité du processeur associée au VPort par défaut peut également être modifiée à l’aide d’une requête de jeu d’OID de OID_NIC_SWITCH_VPORT_PARAMETERS.
LookaheadSize
Ce membre est réservé à une utilisation ultérieure. 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 vPort à une 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 de 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).
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Prise en charge dans NDIS 6.30 et versions ultérieures. |
| serveur minimum pris en charge | Windows Server 2022 |
| d’en-tête | ntddndis.h (include Ndis.h) |