OID_RECEIVE_FILTER_ENUM_FILTERS

项目
06/15/2023

覆盖驱动程序发出OID_RECEIVE_FILTER_ENUM_FILTERS的 OID 方法请求，以获取在网络适配器上配置的所有筛选器的列表。

NDIS_OID_REQUEST 结构的 InformationBuffer 成员包含指向 NDIS_RECEIVE_FILTER_INFO_ARRAY 结构的指针。

从 OID 方法请求成功返回后，NDIS_OID_REQUEST 结构的 InformationBuffer 成员包含指向缓冲区的指针。此缓冲区的格式设置为包含以下内容：

一个NDIS_RECEIVE_FILTER_INFO_ARRAY结构，它指定当前在微型端口驱动程序上配置的接收筛选器的列表。
NDIS_RECEIVE_FILTER_INFO 结构的数组。每个结构指定当前在微型端口驱动程序上配置的接收筛选器的参数。

注解

NDIS 接收筛选器用于以下 NDIS 接口：

NDIS 数据包合并。有关如何在此接口中使用接收筛选器的详细信息，请参阅管理数据包合并接收筛选器。
单根 I/O 虚拟化 (SR-IOV) 。有关如何在此接口中使用接收筛选器的详细信息，请参阅在虚拟端口上设置接收筛选器。
虚拟机队列 (VMQ)。有关如何在此接口中使用接收筛选器的详细信息，请参阅设置和清除 VMQ 筛选器。

过分的驱动程序或应用程序发出OID_RECEIVE_FILTER_ENUM_FILTERS的 OID 方法请求，以枚举在网络适配器上设置的接收筛选器。这包括在 SR-IOV 虚拟端口 (VPort) 或 VMQ 接收队列上设置的接收筛选器。

NDIS 数据包合并接口的其他准则

从 Windows Server 2012 开始，NDIS 数据包合并仅支持网络适配器的默认接收队列。

若要枚举数据包合并接收筛选器，覆盖驱动程序必须将NDIS_RECEIVE_FILTER_INFO_ARRAY结构的 QueueId 成员设置为NDIS_DEFAULT_RECEIVE_QUEUE_ID。

SR-IOV 接口的其他准则

从 Windows Server 2012 开始，SR-IOV 接口仅支持虚拟端口 (VPort) 的默认接收队列。

若要枚举 VPort 接收筛选器，覆盖驱动程序必须将 NDIS_RECEIVE_FILTER_INFO_ARRAY 结构的 QueueId 成员设置为NDIS_DEFAULT_RECEIVE_QUEUE_ID。

VMQ 接口的其他准则

过分的驱动程序可以发出OID_RECEIVE_FILTER_ENUM_FILTERS的 OID 方法请求，以枚举在 VMQ 接收队列上设置的接收筛选器。当 overlying 驱动程序初始化 NDIS_RECEIVE_FILTER_INFO_ARRAY 结构时，它会将 QueueId 成员设置为以下值之一：

非默认接收队列的队列标识符值。 overlying 驱动程序从 OID_RECEIVE_FILTER_ALLOCATE_QUEUE 的早期 OID 方法请求或 OID_RECEIVE_FILTER_ENUM_QUEUES 的 OID 查询请求中获取了队列标识符输入值。
NDIS_DEFAULT_RECEIVE_QUEUE_ID 的队列标识符值，该值指定默认接收队列。