NDIS_NET_BUFFER_LIST_FILTERING_INFO 结构 (ndis.h)

NDIS_NET_BUFFER_LIST_FILTERING_INFO 结构定义与NET_BUFFER_LIST结构关联的筛选信息。

语法

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;

成员

FilteringInfo

包含以下成员的 结构：

FilteringInfo.FilterId

包含接收筛选器标识符的 USHORT 值。 接收筛选器标识符是一个整数，从 1 到网络适配器支持的接收筛选器数。

注意 从 NDIS 6.20 开始，此成员必须设置为零。

 

FilteringInfo.QueueVPortInfo

包含以下成员的联合：

FilteringInfo.QueueVPortInfo.QueueId

一个 USHORT 值，该值包含虚拟机队列 (VMQ) 接收队列的标识符。 队列标识符是介于零和网络适配器支持的队列数之间的整数。 值 NDIS_DEFAULT_RECEIVE_QUEUE_ID 指定默认接收队列。

注意从 Windows Server 2012 开始，必须始终将此成员的值设置为由支持 SR-IOV 接口的微型端口驱动程序NDIS_DEFAULT_RECEIVE_QUEUE_ID。

 

FilteringInfo.QueueVPortInfo.VPortId

一个 USHORT 值，该值包含虚拟端口 (VPort) 的标识符。 值 NDIS_DEFAULT_VPORT_ID 指定 NIC 交换机上的默认 VPort。

具有指定 VPortId 值的 VPort 之前必须通过 OID_NIC_SWITCH_CREATE_VPORT集请求创建。

注意 对于 VMQ 接口，此成员必须设置为 NDIS_DEFAULT_VPORT_ID。

 

Value

与 FilteringInfo 成员联合中的 PVOID 类型值。 此成员允许驱动程序以一个 PVOID 值的形式访问 NDIS_NET_BUFFER_LIST_FILTERING_INFO 结构中的所有信息。

注解

从 NDIS 6.20 开始，微型端口驱动程序使用 NDIS_NET_BUFFER_LIST_FILTERING_INFO 结构来指定与 NET_BUFFER_LIST 结构关联的 NET_BUFFER 结构附带 的 接收筛选器信息。

为了从 NET_BUFFER_LIST OOB 数据访问NDIS_NET_BUFFER_LIST_FILTERING_INFO结构，NDIS 驱动程序调用 NET_BUFFER_LIST_INFO 宏并指定 NetBufferListFilteringInfo 信息类型。

若要直接访问标识符值，请使用 NET_BUFFER_LIST_RECEIVE_FILTER_ID、 NET_BUFFER_LIST_RECEIVE_FILTER_VPORT_ID 或 NET_BUFFER_LIST_RECEIVE_QUEUE_ID 宏。

要求

要求	值
最低受支持的客户端	在 NDIS 6.20 及更高版本中受支持。
标头	ndis.h (包括 Ndis.h)

另请参阅

NDIS_OBJECT_HEADER

NET_BUFFER

NET_BUFFER_LIST

NET_BUFFER_LIST_RECEIVE_FILTER_ID

NET_BUFFER_LIST_RECEIVE_FILTER_VPORT_ID

NET_BUFFER_LIST_RECEIVE_QUEUE_ID