structure NDIS_RECEIVE_FILTER_INFO_ARRAY (ntddndis.h)

Article
08/07/2023

La structure NDIS_RECEIVE_FILTER_INFO_ARRAY spécifie une liste de filtres de réception actuellement configurés sur un pilote miniport.

Les filtres de réception NDIS sont utilisés dans les interfaces NDIS suivantes :

NDIS Packet Coalescing. Pour plus d’informations sur l’utilisation des filtres de réception dans cette interface, consultez Gestion des filtres de réception de coalescing de paquets.
Virtualisation d’E/S racine unique (SR-IOV). Pour plus d’informations sur l’utilisation des filtres de réception dans cette interface, consultez Définition d’un filtre de réception sur un port virtuel.
Virtual Machine Queue (VMQ). Pour plus d’informations sur l’utilisation des filtres de réception dans cette interface, consultez Définition et suppression des filtres VMQ.

Syntaxe

typedef struct _NDIS_RECEIVE_FILTER_INFO_ARRAY {
  NDIS_OBJECT_HEADER       Header;
  NDIS_RECEIVE_QUEUE_ID    QueueId;
  ULONG                    FirstElementOffset;
  ULONG                    NumElements;
  ULONG                    ElementSize;
  ULONG                    Flags;
  NDIS_NIC_SWITCH_VPORT_ID VPortId;
} NDIS_RECEIVE_FILTER_INFO_ARRAY, *PNDIS_RECEIVE_FILTER_INFO_ARRAY;

Membres

Header

Type, révision et taille de la structure NDIS_RECEIVE_FILTER_INFO_ARRAY . Ce membre est mis en forme en tant que structure NDIS_OBJECT_HEADER .

Le pilote miniport doit définir le membre Type de l’en-tête sur NDIS_OBJECT_TYPE_DEFAULT. Pour spécifier la version de la structure NDIS_RECEIVE_FILTER_INFO_ARRAY , le pilote doit définir le membre Revision de Header sur la valeur suivante :

NDIS_SIZEOF_RECEIVE_FILTER_INFO_ARRAY_REVISION_2

Ajout de membres pour NDIS 6.30.

Définissez le membre Size sur NDIS_SIZEOF_RECEIVE_FILTER_INFO_ARRAY_REVISION_2.

NDIS_SIZEOF_RECEIVE_FILTER_INFO_ARRAY_REVISION_1

Version d’origine pour NDIS 6.20.

Définissez le membre Size sur NDIS_SIZEOF_RECEIVE_FILTER_INFO_ARRAY_REVISION_1.

QueueId

Identificateur de file d’attente de réception. Cet identificateur est un entier compris entre zéro et le nombre de files d’attente pris en charge par la carte réseau. La valeur NDIS_DEFAULT_RECEIVE_QUEUE_ID spécifie la file d’attente de réception par défaut.

Note Les pilotes miniports qui prennent en charge le regroupement de paquets NDIS ou l’interface SR-IOV doivent définir le membre QueueId sur NDIS_DEFAULT_RECEIVE_QUEUE_ID.

FirstElementOffset

Décalage, en octets, vers le premier élément d’un tableau d’éléments qui suivent cette structure. Le décalage est mesuré du début de la structure NDIS_RECEIVE_FILTER_INFO_ARRAY jusqu’au début du premier élément. Chaque élément du tableau est une structure NDIS_RECEIVE_FILTER_INFO .

Note Si NumElements est défini sur zéro, ce membre est ignoré.

NumElements

Nombre d’éléments dans le tableau.

ElementSize

Taille en octets de chaque élément contenu dans le tableau.

Flags

Or au niveau du bit des indicateurs suivants :

NDIS_RECEIVE_FILTER_INFO_ARRAY_VPORT_ID_SPECIFIED

Si cet indicateur est défini, des informations sont demandées sur les filtres de réception configurés sur le port virtuel (VPort) spécifié par le membre VPortId .

Note Cet indicateur est valide uniquement pour l’interface SR-IOV.

VPortId

Identificateur de port virtuel (VPort) sur lequel les filtres de réception sont interrogés. L’identificateur VPort doit être l’une des valeurs suivantes :

Identificateur d’un VPort précédemment alloué via une demande de méthode OID de OID_NIC_SWITCH_CREATE_VPORT.
Valeur de NDIS_DEFAULT_VPORT_ID qui spécifie le VPort par défaut sur le commutateur de carte réseau.

Un commutateur de carte réseau est pris en charge par les cartes réseau pour l’interface SR-IOV. Le commutateur de carte réseau peut être configuré pour avoir un ou plusieurs VPorts.

Note Le membre VPortId est valide uniquement si l’indicateur NDIS_RECEIVE_FILTER_INFO_ARRAY_VPORT_ID_SPECIFIED est défini dans Indicateurs.

Remarques

La structure NDIS_RECEIVE_FILTER_INFO_ARRAY est utilisée dans la requête OID de OID_RECEIVE_FILTER_ENUM_FILTERS. Cette demande OID énumère les filtres de réception d’une file d’attente de réception VMQ ou SR-IOV. Chaque élément du tableau qui suit la structure NDIS_RECEIVE_FILTER_INFO_ARRAY est un NDIS_RECEIVE_FILTER_INFO structure.