NDIS_RECEIVE_FILTER_INFO structure (ntddndis.h)

Article
02/29/2024

La structure NDIS_RECEIVE_FILTER_INFO contient des informations sur un filtre de réception actuellement configuré sur un pilote miniport.

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

Fusion des paquets NDIS. Pour plus d’informations sur l’utilisation des filtres de réception dans cette interface, consultez Gestion des filtres de réception de fusion 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 effacement des filtres VMQ.

Syntaxe

typedef struct _NDIS_RECEIVE_FILTER_INFO {
  NDIS_OBJECT_HEADER       Header;
  ULONG                    Flags;
  NDIS_RECEIVE_FILTER_TYPE FilterType;
  NDIS_RECEIVE_FILTER_ID   FilterId;
} NDIS_RECEIVE_FILTER_INFO, *PNDIS_RECEIVE_FILTER_INFO;

Membres

Header

Structure NDIS_OBJECT_HEADER de la structure NDIS_RECEIVE_FILTER_INFO . Le pilote définit le membre Type de la structure spécifiée par Header sur NDIS_OBJECT_TYPE_DEFAULT.

Pour indiquer la version de la structure NDIS_RECEIVE_FILTER_INFO , le pilote définit le membre Revision sur l’une des valeurs suivantes :

NDIS_RECEIVE_FILTER_INFO_REVISION_1

Version d’origine de NDIS 6.20.

Le pilote définit le membre Size sur NDIS_SIZEOF_RECEIVE_FILTER_INFO_REVISION_1.

Flags

Or au niveau du bit d’indicateurs. Ce membre est réservé à NDIS.

FilterType

Type du filtre de réception.

FilterId

Identificateur de filtre de réception. L’identificateur de filtre est un entier compris entre un et le nombre de filtres de réception pris en charge par la carte réseau. La valeur zéro n’est pas valide.

Remarques

La structure NDIS_RECEIVE_FILTER_INFO est utilisée avec le NDIS_RECEIVE_FILTER_INFO_ARRAY structure de la requête OID de OID_RECEIVE_FILTER_ENUM_FILTERS. Cette requête OID énumère les filtres de réception qui ont été configurés sur le pilote miniport. Cela inclut les filtres de réception de fusion de paquets ou les filtres de réception configurés sur une file d’attente de réception utilisée dans l’interface VMQ ou SR-IOV.