structure NDIS_RECEIVE_QUEUE_INFO (ntddndis.h)

Article
02/07/2025

La structure NDIS_RECEIVE_QUEUE_INFO contient des informations sur une file d’attente de réception sur une carte réseau.

Syntaxe

typedef struct _NDIS_RECEIVE_QUEUE_INFO {
  NDIS_OBJECT_HEADER                   Header;
  ULONG                                Flags;
  NDIS_RECEIVE_QUEUE_TYPE              QueueType;
  NDIS_RECEIVE_QUEUE_ID                QueueId;
  NDIS_RECEIVE_QUEUE_GROUP_ID          QueueGroupId;
  NDIS_RECEIVE_QUEUE_OPERATIONAL_STATE QueueState;
  GROUP_AFFINITY                       ProcessorAffinity;
  ULONG                                NumSuggestedReceiveBuffers;
  ULONG                                MSIXTableEntry;
  ULONG                                LookaheadSize;
  NDIS_VM_NAME                         VmName;
  NDIS_QUEUE_NAME                      QueueName;
  ULONG                                NumFilters;
  ULONG                                InterruptCoalescingDomainId;
} NDIS_RECEIVE_QUEUE_INFO, *PNDIS_RECEIVE_QUEUE_INFO;

Membres

Header

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

NDIS_RECEIVE_QUEUE_INFO_REVISION_2

Ajout de membres supplémentaires 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_RECEIVE_QUEUE_INFO_REVISION_2.

NDIS_RECEIVE_QUEUE_INFO_REVISION_1

Version d’origine de NDIS 6.20.

Définissez le membre Size sur NDIS_SIZEOF_RECEIVE_QUEUE_INFO_REVISION_1.

Flags

Valeur de ULONG qui contient une OU d’indicateurs au niveau du bit. Ce membre est réservé à NDIS.

QueueType

Valeur d’énumération NDIS_RECEIVE_QUEUE_TYPE qui spécifie le type de la file d’attente de réception.

QueueId

Valeur de type NDIS_RECEIVE_QUEUE_ID qui contient un identificateur de file d’attente de réception. Cet identificateur est une valeur entière comprise entre zéro et le nombre de files d’attente que la carte réseau prend en charge. Une valeur de NDIS_DEFAULT_RECEIVE_QUEUE_ID spécifie la file d’attente de réception par défaut.

QueueGroupId

Ce membre est réservé à NDIS.

QueueState

Valeur d’énumération NDIS_RECEIVE_QUEUE_OPERATIONAL_STATE qui spécifie l’état opérationnel de la file d’attente de réception.

ProcessorAffinity

Image bitmap GROUP_AFFINITY qui spécifie l’UC avec laquelle la file d’attente a l’affinité. Par exemple, la définition du bit 0 indique que l’UC 0 est utilisée, la définition du bit 1 indique que le processeur 1 est utilisé, et ainsi de suite. Étant donné qu’une file d’attente de machine virtuelle est associée à un processeur, toutes les indications de réception de la file d’attente sont gérées sur ce processeur.

NumSuggestedReceiveBuffers

Valeur ULONG qui contient une valeur suggérée pour le nombre de mémoires tampons de réception que la carte réseau doit utiliser pour prendre en charge la file d’attente. Ce nombre peut être ajusté par rapport aux ressources que le pilote miniport a disponibles ou en proportion du nombre que la carte réseau utilise pour d’autres files d’attente. Par exemple, le nombre réel de mémoires tampons de réception peut être double ou la moitié de cette valeur suggérée.

MSIXTableEntry

Valeur ULONG qui contient l’index d’entrée de table MSI-X pour la file d’attente.

LookaheadSize

Valeur ULONG pour la taille, en octets, de la taille de la tête requise pour cette file d’attente. Une carte réseau qui prend en charge lookahead dans les files d’attente de machines virtuelles fractionne un paquet reçu à un décalage égal ou supérieur à la taille de lookahead demandée et utilise DMA pour transférer les données de lookahead et les données post-lookahead pour séparer les segments de mémoire partagée.

Remarque À partir de NDIS 6.30, le fractionnement des données de paquets en mémoires tampons de lookahead distinctes n’est plus pris en charge. La valeur de ce membre doit être définie sur zéro.

VmName

Valeur NDIS_VM_NAME qui contient la description conviviale de la machine virtuelle.

QueueName

Valeur NDIS_QUEUE_NAME qui contient la description conviviale de la file d’attente.

NumFilters

Valeur ULONG qui spécifie le nombre de filtres de réception qui ont été configurés sur la carte réseau.

Remarque À partir de NDIS 6.30, le pilote miniport doit conserver un compteur pour le nombre actuel de filtres de réception définis sur la carte réseau. Le pilote doit incrémenter le compteur chaque fois qu’un filtre de réception est défini par le biais d’une requête de jeu d’OID de OID_RECEIVE_FILTER_SET_FILTER. Le pilote doit également décrémenter le compteur chaque fois qu’un filtre de réception est effacé par le biais d’une demande de jeu d’OID de OID_RECEIVE_FILTER_CLEAR_FILTER.

InterruptCoalescingDomainId

Valeur ULONG réservée à utiliser par NDIS. Cette valeur est utilisée à des fins d’information par le pilote miniport.

Remarques

La structure NDIS_RECEIVE_QUEUE_INFO est utilisée avec la structure NDIS_RECEIVE_QUEUE_INFO_ARRAY pour le OID_RECEIVE_FILTER_ENUM_QUEUES OID qui énumère les files d’attente de réception sur une carte réseau.

Avec un retour réussi de l' OID_RECEIVE_FILTER_ENUM_QUEUES, NDIS fournit une structure NDIS_RECEIVE_QUEUE_INFO_ARRAY qui définit les propriétés du tableau de files d’attente de réception. Chaque élément du tableau est une structure NDIS_RECEIVE_QUEUE_INFO.