OID_RECEIVE_FILTER_PARAMETERS

覆盖驱动程序发出OID_RECEIVE_FILTER_PARAMETERS的 OID 方法请求,以获取网络适配器上筛选器的当前配置参数。

NDIS_OID_REQUEST 结构的 InformationBuffer 成员包含指向NDIS_RECEIVE_FILTER_PARAMETERS结构的指针。 NDIS 使用输入结构中的 FilterId 成员来标识筛选器。

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

注解

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

过分的驱动程序发出OID_RECEIVE_FILTER_PARAMETERS的 OID 方法请求,以获取在网络适配器上设置的接收筛选器的配置参数。 这包括在 VMQ 接收队列或 SR-IOV 虚拟端口上设置的接收筛选器 (VPort) ,以及下载到微型端口驱动程序的数据包合并筛选器。

overlying 驱动程序从 OID_RECEIVE_FILTER_SET_FILTER 的早期 OID 方法请求或从 OID_RECEIVE_FILTER_ENUM_FILTERS 的 OID 请求中获取筛选器标识符。

返回状态代码

NDIS 处理微型端口驱动程序OID_RECEIVE_FILTER_PARAMETERS的 OID 请求,并返回以下状态代码之一:

NDIS_STATUS_SUCCESS
请求已成功完成。 InformationBuffer 指向NDIS_RECEIVE_FILTER_PARAMETERS结构。

NDIS_STATUS_PENDING
请求正在等待完成。 请求完成后,NDIS 会将最终状态代码和结果传递给调用方 OID 请求完成处理程序。

NDIS_STATUS_INVALID_PARAMETER
过度覆盖的驱动程序或应用程序提供了无效的筛选器标识符。 如果筛选器标识符为零或指定了未定义的筛选器,则筛选器标识符无效。

NDIS_STATUS_INVALID_LENGTH
信息缓冲区太短。 NDIS 设置数据。QUERY_INFORMATION。NDIS_OID_REQUEST结构中的 BytesNeeded 成员达到所需的最小缓冲区大小。

NDIS_STATUS_FAILURE
由于其他原因,请求失败。

要求

版本

在 NDIS 6.20 及更高版本中受支持。

标头

Ntddndis.h (包括 Ndis.h)

另请参阅

NDIS_OID_REQUEST

OID_RECEIVE_FILTER_ENUM_FILTERS

NDIS_RECEIVE_FILTER_PARAMETERS

OID_RECEIVE_FILTER_SET_FILTER