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_RECEIVE_FILTER_PARAMETERS结构,用于指定 NDIS 接收筛选器的参数。
NDIS_RECEIVE_FILTER_FIELD_PARAMETERS结构的数组,用于指定网络数据包标头中字段的筛选器测试条件。
注解
NDIS 接收筛选器用于以下 NDIS 接口:
NDIS 数据包合并。 有关如何在此接口中使用接收筛选器的详细信息,请参阅 管理数据包合并接收筛选器。
单根 I/O 虚拟化 (SR-IOV) 。 有关如何在此接口中使用接收筛选器的详细信息,请参阅 在虚拟端口上设置接收筛选器。
虚拟机队列 (VMQ)。 有关如何在此接口中使用接收筛选器的详细信息,请参阅 设置和清除 VMQ 筛选器。
过分的驱动程序发出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) |
另请参阅
OID_RECEIVE_FILTER_ENUM_FILTERS