Partager via

structure NDIS_NIC_SWITCH_CAPABILITIES (ntddndis.h)

  • Article

La structure NDIS_NIC_SWITCH_CAPABILITIES spécifie les fonctionnalités d’un commutateur de carte réseau sur la carte réseau.

Syntaxe

typedef struct _NDIS_NIC_SWITCH_CAPABILITIES {
  NDIS_OBJECT_HEADER Header;
  ULONG              Flags;
  ULONG              NdisReserved1;
  ULONG              NumTotalMacAddresses;
  ULONG              NumMacAddressesPerPort;
  ULONG              NumVlansPerPort;
  ULONG              NdisReserved2;
  ULONG              NdisReserved3;
  ULONG              NicSwitchCapabilities;
  ULONG              MaxNumSwitches;
  ULONG              MaxNumVPorts;
  ULONG              NdisReserved4;
  ULONG              MaxNumVFs;
  ULONG              MaxNumQueuePairs;
  ULONG              NdisReserved5;
  ULONG              NdisReserved6;
  ULONG              NdisReserved7;
  ULONG              MaxNumQueuePairsPerNonDefaultVPort;
  ULONG              NdisReserved8;
  ULONG              NdisReserved9;
  ULONG              NdisReserved10;
  ULONG              NdisReserved11;
  ULONG              NdisReserved12;
  ULONG              MaxNumMacAddresses;
  ULONG              NdisReserved13;
  ULONG              NdisReserved14;
  ULONG              NdisReserved15;
  ULONG              NdisReserved16;
  ULONG              NdisReserved17;
  ULONG              MaxNumRssCapableNonDefaultPFVPorts;
  ULONG              NumberOfIndirectionTableEntriesForDefaultVPort;
  ULONG              NumberOfIndirectionTableEntriesPerNonDefaultPFVPort;
  ULONG              MaxNumQueuePairsForDefaultVPort;
} NDIS_NIC_SWITCH_CAPABILITIES, *PNDIS_NIC_SWITCH_CAPABILITIES;

Membres

Header

Type, révision et taille de la structure NDIS_NIC_SWITCH_CAPABILITIES. 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_CAPABILITIES, le pilote doit définir le membre Revision de Header sur l’une des valeurs suivantes :

NDIS_NIC_SWITCH_CAPABILITIES_REVISION_3

Ajout des membres de l’interface RSS pour NDIS 6.60.

Remarque Révision 3 de cette structure est prise en charge uniquement sur Windows Server 2016 et versions ultérieures de Windows Server.

 

Définissez le membre Size sur NDIS_SIZEOF_NIC_SWITCH_CAPABILITIES_REVISION_3.

NDIS_NIC_SWITCH_CAPABILITIES_REVISION_2

Ajout des membres de l’interface de virtualisation d’E/S racine unique (SR-IOV) pour NDIS 6.30.

Remarque Révision 2 de cette structure est prise en charge uniquement sur Windows Server 2012 et versions ultérieures de Windows Server.

 

Définissez le membre taille sur NDIS_SIZEOF_NIC_SWITCH_CAPABILITIES_REVISION_2.

NDIS_NIC_SWITCH_CAPABILITIES_REVISION_1

Version d’origine de NDIS 6.20.

Définissez le membre taille de sur NDIS_SIZEOF_NIC_SWITCH_CAPABILITIES_REVISION_1.

Flags

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

NdisReserved1

Réservé à NDIS.

NumTotalMacAddresses

Valeur ULONG qui contient le nombre total d’adresses mac (Media Access Control) que la carte réseau prend en charge.

Remarque Pilotes doivent définir ce membre sur zéro pour la révision 2 et les révisions ultérieures de cette structure.
 

NumMacAddressesPerPort

Valeur ULONG qui contient le nombre d’adresses MAC prises en charge pour chaque port.

Remarque Pilotes doivent définir ce membre sur zéro pour la révision 2 et les révisions ultérieures de cette structure.
 

NumVlansPerPort

Valeur ULONG qui contient le nombre de réseaux locaux virtuels pris en charge pour chaque port.

Remarque Pilotes doivent définir ce membre sur zéro pour la révision 2 et les révisions ultérieures de cette structure.
 

NdisReserved2

Réservé à NDIS.

NdisReserved3

Réservé à NDIS.

NicSwitchCapabilities

Valeur ULONG qui contient une or au niveau du bit des indicateurs suivants qui spécifient les fonctionnalités du commutateur de carte réseau :

NDIS_NIC_SWITCH_CAPS_RSS_ON_PF_VPORTS_SUPPORTED

Remarque Cet indicateur est pris en charge dans Windows Server 2016 et versions ultérieures. Il a été introduit dans NDIS 6.60.

Spécifie que la carte réseau prend en charge VMMQ pour pf VPorts.

NDIS_NIC_SWITCH_CAPS_RSS_PER_PF_VPORT_INDIRECTION_TABLE_SUPPORTED

Remarque Cet indicateur est pris en charge dans Windows Server 2016 et versions ultérieures. Il a été introduit dans NDIS 6.60.

Si la valeur est 1, spécifie que la carte réseau est en mesure de gérer les tables d’indirection VPort par PF.

NDIS_NIC_SWITCH_CAPS_RSS_PER_PF_VPORT_HASH_FUNCTION_SUPPORTED

Remarque Cet indicateur est pris en charge dans Windows Server 2016 et versions ultérieures. Il a été introduit dans NDIS 6.60.

Si la valeur est 1, spécifie que la carte réseau prend en charge la définition d’une fonction de hachage différente par VPort PF. Si cet indicateur est défini, NDIS_NIC_SWITCH_CAPS_RSS_PER_PF_VPORT_HASH_KEY_SUPPORTED doit également être défini.

NDIS_NIC_SWITCH_CAPS_RSS_PER_PF_VPORT_HASH_TYPE_SUPPORTED

Remarque Cet indicateur est pris en charge dans Windows Server 2016 et versions ultérieures. Il a été introduit dans NDIS 6.60.

Si la valeur est 1, spécifie que la carte réseau prend en charge la définition de différents types de hachage par port virtuel PF.

NDIS_NIC_SWITCH_CAPS_RSS_PER_PF_VPORT_HASH_KEY_SUPPORTED

Remarque Cet indicateur est pris en charge dans Windows Server 2016 et versions ultérieures. Il a été introduit dans NDIS 6.60.

Si la valeur est 1, spécifie que la carte réseau prend en charge la définition d’une clé secrète de hachage différente par VPort PF. Cet indicateur doit être défini si NDIS_NIC_SWITCH_CAPS_RSS_PER_PF_VPORT_HASH_FUNCTION_SUPPORTED est défini.

NDIS_NIC_SWITCH_CAPS_RSS_PER_PF_VPORT_INDIRECTION_TABLE_SIZE_RESTRICTED

Remarque Cet indicateur est pris en charge dans Windows Server 2016 et versions ultérieures. Il a été introduit dans NDIS 6.60.

Si la valeur est 1, spécifie que la carte réseau a une limitation de la taille de table d’indirection pour les ports virtuels PF. Cet indicateur force l’émetteur d’un OID RSS à utiliser une taille de table d’indirection VPort par PF égale au nombre de files d’attente VPort arrondies à la puissance suivante de deux. Cela s’applique uniquement aux VPorts PF et ne s’applique pas aux VPorts VF. Cet indicateur peut être combiné avec l’indicateur de NDIS_NIC_SWITCH_CAPS_ASYMMETRIC_QUEUE_PAIRS_FOR_NONDEFAULT_VPORT_SUPPORTED (différents ports virtuels PF peuvent avoir différents nombres de files d’attente). Cet indicateur empêche les utilisateurs VMMQ d’effectuer une direction de file d’attente affinée.

NDIS_NIC_SWITCH_CAPS_NIC_SWITCH_WITHOUT_IOV_SUPPORTED

Remarque Cet indicateur est pris en charge dans Windows Server 2016 et versions ultérieures.

Cet indicateur, introduit avec NDIS 6.60, spécifie qu’un commutateur de carte réseau peut être créé sans utiliser SR-IOV. Cet indicateur permet de séparer un commutateur de carte réseau du mot clé *SRIOV, ce qui signifie qu’un commutateur de carte réseau peut être créé via OID_NIC_SWITCH_CREATE_SWITCH même si *SRIOV = 0.

Pour plus d’informations sur la création de rapports sur les fonctionnalités de commutateur de carte réseau pour les pilotes miniport NDIS 6.60 et ultérieurs, consultez Détermination des fonctionnalités de commutateur de carte réseau.

NDIS_NIC_SWITCH_CAPS_VLAN_SUPPORTED

Cet indicateur spécifie que le commutateur de carte réseau prend en charge le filtrage de paquets matériels en fonction de l’identificateur (ID) du réseau local virtuel (VLAN).

Remarque Cet indicateur doit être défini uniquement si le commutateur de carte réseau prend en charge le filtrage d’ID de réseau local virtuel sur des ports virtuels individuels SR-IOV (VPorts).
 

NDIS_NIC_SWITCH_CAPS_PER_VPORT_INTERRUPT_MODERATION_SUPPORTED

Cet indicateur spécifie que le commutateur de carte réseau peut prendre en charge la configuration de modération des interruptions sur des ports virtuels individuels.

NDIS_NIC_SWITCH_CAPS_ASYMMETRIC_QUEUE_PAIRS_FOR_NONDEFAULT_VPORT_SUPPORTED

Cet indicateur spécifie que le commutateur de carte réseau peut configurer un nombre différent de paires de files d’attente pour chaque port virtuel non défini. Cela signifie que chaque port virtuel non défini peut être configuré de manière asymétrique pour avoir un nombre différent de paires de files d’attente.

Si cet indicateur n’est pas défini, tous les ports virtuels non définis doivent être configurés de manière symétrique pour avoir le même nombre de paires de files d’attente.

Indépendamment de la définition de cet indicateur, le commutateur de carte réseau doit prendre en charge la possibilité de définir le nombre de paires de files d’attente sur le VPort par défaut. Celles-ci peuvent différer du nombre de paires de files d’attente définies sur les ports virtuels non définis.

Remarque 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.
 
Pour plus d’informations, consultez affectation symétrique et asymétrique des paires de files d’attente.

NDIS_NIC_SWITCH_CAPS_VF_RSS_SUPPORTED

Cet indicateur spécifie que les paires de files d’attente provenant de ports virtuels non définis par défaut qui sont attachées à une fonction virtuelle PCI Express (PCIe) peuvent être utilisées pour la mise à l’échelle côté réception (RSS). Le pilote miniport VF s’exécute dans le système d’exploitation invité d’une partition enfant Hyper-V.

Si cet indicateur est défini, le pilote miniport prend en charge RSS sur une machine virtuelle et peut utiliser une ou plusieurs paires de files d’attente à partir du port virtuel non défini pour RSS.

Remarque à partir de Windows Server 2012, une seule fenêtre virtuelle non définie peut être attachée à une machine virtuelle.
 

NDIS_NIC_SWITCH_CAPS_SINGLE_VPORT_POOL

Cet indicateur spécifie que les ports virtuels non définis peuvent être créés de manière non réservée à partir du pool VPort sur la carte réseau. Cela permet aux ports virtuels non définis disponibles d’être créés et attribués selon les besoins aux machines virtuelles PF et allouées. Si la carte réseau prend en charge l’interface de file d’attente de machines virtuelles (VMQ), les ports virtuels non définis par défaut qui sont affectés au PF peuvent également être utilisés pour les files d’attente de réception de machine virtuelle.

Remarque Le VPort par défaut est toujours réservé à l’affectation au PF.
 
Si cet indicateur est défini, les ports virtuels non définis sont créés et affectés aux machines virtuelles PF et allouées. Toutefois, ce mécanisme ne réserve pas les ports virtuels non définis pour la création et l’affectation de VF. Par conséquent, des situations peuvent se produire lorsqu’une VF peut ne pas être affectée à un VPort si le pool a été épuisé de VPorts disponibles.
Remarque Si une VF ne peut pas être affectée à un VPort, le trafic de paquets sur la machine virtuelle se produit sur le chemin d’accès aux données synthétiques SR-IOV. Pour plus d’informations sur ce chemin de données, consultez SR-IOV chemins de données.
 
Si cet indicateur n’est pas défini, la création et l’affectation de vPorts non définis sont réservées pour l’attribution de VF. Des ports virtuels non définis peuvent être créés et affectés au PF.

Pour plus d’informations sur VMQ, consultez file d’attente de machines virtuelles (VMQ).

Pour plus d’informations sur les ports virtuels, consultez Gestion des ports virtuels.

MaxNumSwitches

Valeur ULONG qui spécifie le nombre maximal de commutateurs qui peuvent être créés sur la fonction physique PCI Express (PCIe) de la carte réseau (PF).

Remarque à partir de Windows Server 2012, Windows prend uniquement en charge le commutateur de carte réseau par défaut sur la carte réseau. Par conséquent, ce membre doit toujours être défini sur un.
 

MaxNumVPorts

Valeur ULONG qui spécifie le nombre maximal de ports virtuels qui peuvent être créés sur une carte réseau. Cela inclut le VPort par défaut qui est toujours attaché au PF.

Remarque Le commutateur de carte réseau doit prendre en charge au moins (MaxNumVFs + 1) VPorts.
 

NdisReserved4

Réservé à NDIS.

MaxNumVFs

Valeur ULONG qui spécifie le nombre maximal de machines virtuelles qui peuvent être créées sur le commutateur de carte réseau.

Remarque Selon les ressources matérielles disponibles sur la carte réseau, le pilote miniport peut définir le membre MaxNumVFs sur une valeur inférieure à son *NumVFs mot clé. Pour plus d’informations sur ce mot clé, consultez mots clés INF standardisés pour sr-IOV.
 

MaxNumQueuePairs

Valeur ULONG qui spécifie le nombre maximal de paires de files d’attente qui peuvent être affectées à toutes les ports virtuels. Cela inclut le VPort par défaut attaché au PF.

Remarque Cette valeur doit être supérieure ou égale à la valeur de MaxNumVPorts.
 

NdisReserved5

Réservé à NDIS.

NdisReserved6

Réservé à NDIS.

NdisReserved7

Réservé à NDIS.

MaxNumQueuePairsPerNonDefaultVPort

Valeur ULONG qui spécifie le nombre maximal de paires de files d’attente qui peuvent être affectées à un VPort non défini.

Cette valeur est spécifiée dans les puissances 2 et fournit la configuration asymétrique et l’affectation de paires de files d’attente à VPorts. Pour plus d’informations, consultez affectation symétrique et asymétrique des paires de files d’attente.

NdisReserved8

Réservé à NDIS.

NdisReserved9

Réservé à NDIS.

NdisReserved10

Réservé à NDIS.

NdisReserved11

Réservé à NDIS.

NdisReserved12

Réservé à NDIS.

MaxNumMacAddresses

Valeur ULONG qui spécifie le nombre maximal de filtres d’adresses MAC monodiffusion disponibles sur le commutateur de carte réseau.

Remarque Cette valeur doit être supérieure ou égale à la valeur de MaxNumVPorts. Cela permet à chaque VPort (y compris le VPort par défaut) d’être configuré pour avoir au moins un filtre d’adresse MAC monodiffusion.
 

NdisReserved13

Réservé à NDIS.

NdisReserved14

Réservé à NDIS.

NdisReserved15

Réservé à NDIS.

NdisReserved16

Réservé à NDIS.

NdisReserved17

Réservé à NDIS.

MaxNumRssCapableNonDefaultPFVPorts

Valeur ULONG qui spécifie le nombre maximal de PFVPorts compatibles RSS non par défaut.

NumberOfIndirectionTableEntriesForDefaultVPort

Valeur ULONG qui spécifie le nombre d’entrées de table d’indirection pour le VPort par défaut.

NumberOfIndirectionTableEntriesPerNonDefaultPFVPort

Valeur ULONG qui spécifie le nombre d’entrées de table d’indirection pour chaque PFVPort non par défaut.

MaxNumQueuePairsForDefaultVPort

Valeur ULONG qui spécifie le nombre maximal de paires de files d’attente qui peuvent être affectées au VPort par défaut.

Cette valeur est spécifiée dans les puissances 2 et fournit la configuration asymétrique et l’affectation de paires de files d’attente à VPorts. Pour plus d’informations, consultez affectation symétrique et asymétrique des paires de files d’attente.

Remarques

La structure NDIS_NIC_SWITCH_CAPABILITIES est utilisée dans les membres des structures suivantes :

Requêtes de requête OID de OID_NIC_SWITCH_CURRENT_CAPABILITIES et OID_NIC_SWITCH_HARDWARE_CAPABILITIES retourner une structure de NDIS_NIC_SWITCH_CAPABILITIES.

Exigences

Exigence Valeur
client minimum pris en charge Pris en charge dans NDIS 6.20 et versions ultérieures.
d’en-tête ntddndis.h (include Ndis.h)

Voir aussi

NDIS_BIND_PARAMETERS

NDIS_FILTER_ATTACH_PARAMETERS

NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES

NDIS_OBJECT_HEADER

OID_NIC_SWITCH_CREATE_VPORT

OID_NIC_SWITCH_CURRENT_CAPABILITIES

OID_NIC_SWITCH_HARDWARE_CAPABILITIES