NDIS_NET_BUFFER_LIST_FILTERING_INFO structure (ndis.h)

Article
08/07/2023

La structure NDIS_NET_BUFFER_LIST_FILTERING_INFO définit les informations de filtrage associées à une structure NET_BUFFER_LIST .

Syntaxe

typedef struct _NDIS_NET_BUFFER_LIST_FILTERING_INFO {
  union {
    struct {
      USHORT FilterId;
      union {
        USHORT QueueId;
        USHORT VPortId;
      } QueueVPortInfo;
    } FilteringInfo;
    PVOID Value;
  };
} NDIS_NET_BUFFER_LIST_FILTERING_INFO, *PNDIS_NET_BUFFER_LIST_FILTERING_INFO;

Membres

FilteringInfo

Structure qui contient les membres suivants :

FilteringInfo.FilterId

Valeur USHORT qui contient un identificateur de filtre de réception. L’identificateur de filtre de réception est un entier compris entre un et le nombre de filtres de réception pris en charge par la carte réseau.

Note À compter de NDIS 6.20, ce membre doit être défini sur zéro.

FilteringInfo.QueueVPortInfo

Union qui contient les membres suivants :

FilteringInfo.QueueVPortInfo.QueueId

Valeur USHORT qui contient un identificateur pour une file d’attente de réception de machines virtuelles . L’identificateur de file d’attente est un entier compris entre zéro et le nombre de files d’attente que la carte réseau prend en charge. La valeur NDIS_DEFAULT_RECEIVE_QUEUE_ID spécifie la file d’attente de réception par défaut.

Note À compter de Windows Server 2012, la valeur de ce membre doit toujours être définie sur NDIS_DEFAULT_RECEIVE_QUEUE_ID par les pilotes miniport qui prennent en charge l’interface SR-IOV.

FilteringInfo.QueueVPortInfo.VPortId

Valeur USHORT qui contient l’identificateur d’un port virtuel (VPort). La valeur NDIS_DEFAULT_VPORT_ID spécifie le VPort par défaut sur le commutateur de carte réseau.

Le VPort avec la valeur VPortId spécifiée doit avoir été créé précédemment par le biais d’une demande d’ensemble de OID_NIC_SWITCH_CREATE_VPORT.

Note Pour l’interface VMQ, ce membre doit être défini sur NDIS_DEFAULT_VPORT_ID.

Value

Valeur de type PVOID qui est en union avec le membre FilteringInfo . Ce membre permet à un pilote d’accéder à toutes les informations de la structure NDIS_NET_BUFFER_LIST_FILTERING_INFO en tant que valeur PVOID.

Remarques

À compter de NDIS 6.20, les pilotes miniport utilisent la structure NDIS_NET_BUFFER_LIST_FILTERING_INFO pour spécifier les informations de filtre de réception qui accompagnent les structures NET_BUFFER associées à une structure NET_BUFFER_LIST .

Pour accéder à la structure NDIS_NET_BUFFER_LIST_FILTERING_INFO à partir des données OOB NET_BUFFER_LIST, un pilote NDIS appelle la macro NET_BUFFER_LIST_INFO et spécifie le type d’informations NetBufferListFilteringInfo .

Pour accéder directement aux valeurs d’identificateur, utilisez le NET_BUFFER_LIST_RECEIVE_FILTER_ID, NET_BUFFER_LIST_RECEIVE_FILTER_VPORT_ID ou NET_BUFFER_LIST_RECEIVE_QUEUE_ID macros.