structure NDIS_RECEIVE_HASH_PARAMETERS (ntddndis.h)

Article
02/07/2025

La structure NDIS_RECEIVE_HASH_PARAMETERS spécifie les paramètres de hachage de réception d’un adaptateur miniport qui prend en charge les calculs de hachage de réception.

Syntaxe

typedef struct _NDIS_RECEIVE_HASH_PARAMETERS {
  NDIS_OBJECT_HEADER Header;
  ULONG              Flags;
  ULONG              HashInformation;
  USHORT             HashSecretKeySize;
  ULONG              HashSecretKeyOffset;
} NDIS_RECEIVE_HASH_PARAMETERS, *PNDIS_RECEIVE_HASH_PARAMETERS;

Membres

Header

Structure NDIS_OBJECT_HEADER pour la structure NDIS_RECEIVE_HASH_PARAMETERS. Définissez le membre type de la structure spécifiée par -en-tête sur NDIS_OBJECT_TYPE_DEFAULT, le membre Revision sur NDIS_RECEIVE_HASH_PARAMETERS_REVISION_1 et le membre Size sur NDIS_SIZEOF_RECEIVE_HASH_PARAMETERS_REVISION_1.

Flags

Valeur USHORT qui indique ce que le pilote miniport doit faire avec les paramètres de hachage. Le pilote miniport peut utiliser ces indicateurs pour déterminer rapidement quels paramètres ont changé et mettre à jour les paramètres de hachage en conséquence.

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

NDIS_RECEIVE_HASH_FLAG_ENABLE_HASH

Si cet indicateur est défini, activez le calcul des valeurs de hachage sur les images reçues et placez la valeur de hachage calculée dans la NetBufferListHashValue informations OOB dans la structure NET_BUFFER_LIST.

Si cet indicateur est clair, désactivez le calcul des valeurs de hachage sur les images reçues.

Si le calcul de hachage de réception est activé, le pilote miniport doit définir cet indicateur ; sinon, cet indicateur doit être clair.

NDIS_RECEIVE_HASH_FLAG_HASH_INFO_UNCHANGED

Le membre HashInformation n’a pas changé. Les informations de hachage incluent les types de hachage et la fonction de hachage.

Si cet indicateur est défini, le membre HashInformation de la structure NDIS_RECEIVE_HASH_PARAMETERS doit être ignoré.

Si cet indicateur est effacé, le membre HashInformation contient une nouvelle valeur que le pilote miniport doit utiliser pour calculer les valeurs de hachage sur les images reçues.

NDIS_RECEIVE_HASH_FLAG_HASH_KEY_UNCHANGED

La clé secrète et les membres de données associés n’ont pas changé.

Si cet indicateur est défini, la clé secrète et les membres de données associés doivent être ignorés.

Si cet indicateur est effacé, la clé secrète ou les membres de données associés ont changé et le pilote miniport doit utiliser les nouvelles informations.

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

HashInformation

Dans une requête définie, 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.

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

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

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

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.

HashSecretKeyOffset

Décalage du tableau de clés secrètes de la fonction de hachage depuis le début de la structure NDIS_RECEIVE_HASH_PARAMETERS. Utilisez ce décalage pour obtenir la clé secrète 320 bits (40 octets).

Dans une requête définie, la clé secrète peut contenir toutes les données choisies par le pilote surajustement.

Dans une requête de requête, la clé secrète contient les données que la carte réseau utilise.

Remarques

La structure NDIS_RECEIVE_HASH_PARAMETERS définit les paramètres de hachage pour l’OID OID_GEN_RECEIVE_HASH.

Remarque Pilotes de protocole doivent désactiver les calculs de hachage avant d’activer RSS. Si RSS est activé, un pilote de protocole désactive RSS avant d’activer les calculs de hachage de réception. Un pilote miniport doit échouer à une demande pour activer les calculs de hachage de réception ou RSS si l’autre service est actuellement activé.

Remarque La clé secrète est ajoutée après les membres de la structure NDIS_RECEIVE_HASH_PARAMETERS.