structure NDIS_RECEIVE_SCALE_PARAMETERS_V2 (ntddndis.h)

Article
02/07/2025

Avertissement

Certaines informations contenues dans cette rubrique concernent le produit prédéfinit, qui peut être sensiblement modifié avant sa publication commerciale. Microsoft n’offre aucune garantie, expresse ou implicite, en ce qui concerne les informations fournies ici.

RSSv2 est en préversion uniquement dans Windows 10, version 1803.

La structure NDIS_RECEIVE_SCALE_PARAMETERS_V2 spécifie les paramètres RSS (Receive Side Scale) d’un adaptateur miniport qui publie la prise en charge de RSS Version 2 (RSSv2). Il est utilisé dans l’OID OID_GEN_RECEIVE_SCALE_PARAMETERS_V2.

Syntaxe

typedef struct _NDIS_RECEIVE_SCALE_PARAMETERS_V2 {
  NDIS_OBJECT_HEADER Header;
  ULONG              Flags;
  ULONG              HashInformation;
  ULONG              HashSecretKeySize;
  ULONG              HashSecretKeyOffset;
  ULONG              NumberOfQueues;
  ULONG              NumberOfIndirectionTableEntries;
} NDIS_RECEIVE_SCALE_PARAMETERS_V2, *PNDIS_RECEIVE_SCALE_PARAMETERS_V2;

Membres

Header

Structure NDIS_OBJECT_HEADER de la structure NDIS_RECEIVE_SCALE_PARAMETERS_V2. Définissez le membre type de la structure qui d’en-tête spécifie la valeur NDIS_OBJECT_TYPE_RSS_PARAMETERS_V2.

Pour les pilotes NDIS 6.80 et versions ultérieures, définissez le membre Révision sur NDIS_RECEIVE_SCALE_PARAMETERS_V2_REVISION_1 et le membre Size sur sizeof(NDIS_RECEIVE_SCALE_PARAMETERS_V2).

Flags

Valeur ULONG qui indique quels paramètres sont modifiés. Le pilote peut utiliser ces indicateurs pour déterminer rapidement quels paramètres ont changé et mettre à jour les paramètres RSS en conséquence.

Dans une requête de requête, définissez ce membre sur zéro.

Dans une requête définie, les indicateurs sont définis comme suit :

Valeur	Signification
NDIS_RECEIVE_SCALE_PARAM_ENABLE_RSS	La valeur 1 indique que RSS est activé pour l’objet spécifié. Le pilote miniport doit examiner d’autres paramètres. La valeur 0 indique que RSS est désactivé pour l’objet spécifié. Les paramètres NumberOfQueues et NumberOfIndirectionTableEnt ries peuvent changer lorsque RSS est désactivé. D’autres paramètres tels que HashInformation et hashKey doivent être ignorés lorsque RSS est désactivé.
NDIS_RECEIVE_SCALE_PARAM_HASH_INFO_CHANGED	La valeur du paramètre HashInformation a changé.
NDIS_RECEIVE_SCALE_PARAM_HASH_KEY_CHANGED	Le contenu du membre HashSecretKey a changé.
NDIS_RECEIVE_SCALE_PARAM_NUMBER_OF_QUEUES_CHANGED	Le nombre de files d’attente par VPort a changé.
NDIS_RECEIVE_SCALE_PARAM_NUMBER_OF_ENTRIES_CHANGED	Le nombre d’entrées dans la table d’indirection a changé.

HashInformation

Dans une requête définie, ce membre est le type de hachage et la fonction de hachage que la carte réseau doit utiliser pour calculer les valeurs de hachage pour les paquets entrants. Si la fonction de hachage spécifiée dans la hashInformation membre est zéro, RSS est désactivé.

Dans une requête de requête, ce membre est le type de hachage et la fonction de hachage que la carte réseau utilise.

Les pilotes de superposition et NDIS peuvent utiliser la macro NDIS_RSS_HASH_INFO_FROM_TYPE_AND_FUNC pour combiner le type de hachage et la fonction de hachage en informations de hachage et définir le membre HashInformation.

Les pilotes miniport peuvent utiliser la macro NDIS_RSS_HASH_TYPE_FROM_HASH_INFO pour obtenir le type de hachage de hashInformation et la macro NDIS_RSS_HASH_FUNC_FROM_HASH_INFO pour obtenir la fonction de hachage.

Ce paramètre peut être modifié en même temps que RSS est activé, ou par la suite.

HashSecretKeySize

Taille du tableau de clés secrètes de la fonction de hachage, en octets. La taille du tableau est de 40 octets pour NdisHashFunctionToeplitz.

Ce paramètre peut être modifié en même temps que RSS est activé, ou par la suite.

HashSecretKeyOffset

Décalage, en octets, de la clé secrète de hachage.

Ce paramètre peut être modifié en même temps que RSS est activé, ou par la suite.

NumberOfQueues

Nombre maximal de files d’attente pour l’entité de mise à l’échelle. Ce paramètre est un alias pour la variable NUM_QUEUE_PAIRS de la structure NDIS_NIC_SWITCH_VPORT_PARAMETERS, qui peut également être interrogé ou défini via l’OID OID_NIC_SWITCH_VPORT_PARAMETERS. Il peut être modifié lorsque RSS est activé ou désactivé.

NumberOfIndirectionTableEntries

Nombre d’entrées de table d’indirection (ITE) pour l’entité de mise à l’échelle. Cette valeur est une puissance de deux et ne dépasse pas les fonctionnalités de l’adaptateur correspondant. Il peut être modifié au moment de l’activation de RSS, ou par la suite.

De nouvelles valeurs pour ce paramètre sont également une puissance de deux et dépassent les fonctionnalités de l’adaptateur. Lorsque ce nombre est augmenté, le pilote miniport doit cloner la table d’indirection actuelle dans les nouvelles ites autant de fois que nécessaire (cela est possible en raison de la restriction de puissance de deux). Lorsque ce nombre est réduit, la couche supérieure garantit que la partie de la table d’indirection supprimée contient des réplicas exacts de la partie restante.