OID_RECEIVE_FILTER_CURRENT_CAPABILITIES

过度的驱动程序发出OID_RECEIVE_FILTER_CURRENT_CAPABILITIES的 OID 查询请求,以获取当前启用的网络适配器接收筛选功能。

从 OID 查询请求成功返回后,NDIS_OID_REQUEST 结构的 InformationBuffer 成员包含指向 NDIS_RECEIVE_FILTER_CAPABILITIES 结构的指针。

言论

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

从 NDIS 6.20 开始,微型端口驱动程序会在调用其 MiniportInitializeEx 函数时注册当前启用的接收网络适配器的硬件功能。 微型端口驱动程序通过以下步骤注册这些功能:

  1. 驱动程序使用当前启用的接收筛选硬件功能初始化 NDIS_RECEIVE_FILTER_CAPABILITIES 结构。

  2. 驱动程序初始化 NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES 结构,并将 CurrentReceiveFilterCapabilities 成员设置为指向 NDIS_RECEIVE_FILTER_CAPABILITIES 结构的指针。

  3. 微型端口驱动程序调用 NdisMSetMiniportAttributes 函数,并将 MiniportAttributes 参数设置为指向 NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES 结构的指针。

过度配置协议和筛选器驱动程序无需发出OID_RECEIVE_FILTER_CURRENT_CAPABILITIES的 OID 查询请求。 NDIS 以以下方式为这些驱动程序提供当前启用的接收筛选功能:

  • NDIS 提供基础网络适配器的当前启用的接收筛选功能,用于在绑定作期间 NDIS_BIND_PARAMETERS 结构 成员的 ReceiveFilterCapabilities 中的过度协议驱动程序。

  • NDIS 提供基础网络适配器的当前启用的接收筛选功能,以便在附加作期间将 ReceiveFilterCapabilities 中的NDIS_FILTER_ATTACH_PARAMETERS 结构的成员过度筛选驱动程序。

返回状态代码

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

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

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

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

NDIS_STATUS_NOT_SUPPORTED
网络适配器不支持接收筛选。

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

要求

版本

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

页眉

Ntddndis.h (包括 Ndis.h)

另请参阅

NDIS_BIND_PARAMETERS

NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES

NDIS_OID_REQUEST

NDIS_RECEIVE_FILTER_CAPABILITIES