structure NDIS_RECEIVE_SCALE_PARAMETERS_V2 (ntddndis.h)

Article
02/26/2024

Avertissement

Certaines informations de cette rubrique concernent le produit pré-publié, qui peut être sensiblement modifié avant sa commercialisation. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

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

La structure NDIS_RECEIVE_SCALE_PARAMETERS_V2 spécifie les paramètres RSS (Receive Side Scaling) pour un adaptateur miniport qui annonce 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 que l’en-tête spécifie sur NDIS_OBJECT_TYPE_RSS_PARAMETERS_V2.

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

Flags

Valeur ULONG qui indique les paramètres qui 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, définissez ce membre sur zéro.

Dans une demande de jeu, 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 NumberOfIndirectionTableEntries 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 demande d’ensemble, 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 des paquets entrants. Si la fonction de hachage spécifiée dans le membre HashInformation est égale à zéro, RSS est désactivée.

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

Les pilotes overlying 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 à partir 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 capacités de l’adaptateur correspondant. Il peut être modifié avant l’activation du flux RSS ou par la suite.

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