structure NDIS_RECEIVE_HASH_PARAMETERS (ntddndis.h)

Article
02/26/2024

La structure NDIS_RECEIVE_HASH_PARAMETERS spécifie les paramètres de hachage de réception pour 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 de la structure NDIS_RECEIVE_HASH_PARAMETERS. Définissez le membre Type de la structure spécifiée par l’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 demande de jeu, 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 trames reçues et placez la valeur de hachage calculée dans les informations OOB NetBufferListHashValue 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 demande de jeu, 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.

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

Les pilotes sur-mentant 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 miniport peuvent utiliser le NDIS_RSS_HASH_TYPE_FROM_HASH_INFO macro pour obtenir le type de hachage à partir de HashInformation et du 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 à partir du 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 demande de jeu, la clé secrète peut contenir toutes les données choisies par le pilote en sur-position.

Dans une 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 .

Note Les pilotes de protocole doivent désactiver les calculs de hachage de réception 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 d’activation des calculs de hachage de réception ou RSS si l’autre service est actuellement activé.

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