NDIS_STATUS_RECEIVE_FILTER_CURRENT_CAPABILITIES

微型端口驱动程序在当前启用的接收筛选功能发生更改时发出 NDIS_STATUS_RECEIVE_FILTER_CURRENT_CAPABILITIES 状态指示。

注意 此状态指示只能由支持 NDIS 接收筛选器的微型端口驱动程序进行。

当微型端口驱动程序发出此状态指示时,它会将 NDIS_STATUS_INDICATION 结构的 StatusBuffer 成员设置为指向NDIS_RECEIVE_FILTER_CAPABILITIES结构的指针。 驱动程序使用其当前启用的接收筛选器功能初始化此结构。

注解

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

满足以下条件之一时,微型端口驱动程序会发出 NDIS_STATUS_RECEIVE_FILTER_CURRENT_CAPABILITIES 状态指示:

  • 当前启用的接收筛选器功能在单个网络适配器上发生更改。 例如,可以通过独立硬件供应商 (IHV) 开发的管理应用程序启用或禁用接收筛选器。

  • 当前启用的接收筛选器功能会更改属于负载均衡故障转移 (LBFO) 由 MUX 中间驱动程序管理的一个或多个网络适配器。 有关详细信息,请参阅 NDIS MUX 中间驱动程序

微型端口驱动程序在发出 NDIS_STATUS_RECEIVE_FILTER_CURRENT_CAPABILITIES 状态指示时遵循以下步骤:

  1. 微型端口使用网络适配器上当前启用的接收筛选器功能初始化 NDIS_RECEIVE_FILTER_CAPABILITIES 结构。

    微型端口驱动程序初始化 Header 成员时,会将 HeaderType 成员设置为 NDIS_OBJECT_TYPE_DEFAULT。 微型端口驱动程序将 HeaderRevision 成员设置为 NDIS_RECEIVE_FILTER_CAPABILITIES_REVISION_2,将 Size 成员设置为 NDIS_SIZEOF_RECEIVE_FILTER_CAPABILITIES_REVISION_2。

  2. 微型端口驱动程序通过以下方式初始化状态指示的 NDIS_STATUS_INDICATION 结构:

    • StatusCode 成员必须设置为 NDIS_STATUS_RECEIVE_FILTER_CURRENT_CAPABILITIES

    • StatusBuffer 成员必须设置为 NDIS_RECEIVE_FILTER_CAPABILITIES 结构的地址。

    • StatusBufferSize 成员必须设置为 sizeof(NDIS_RECEIVE_FILTER_CAPABILITIES)

  3. 微型端口驱动程序通过调用 NdisMIndicateStatusEx 发出状态指示。 驱动程序必须将指向 NDIS_STATUS_INDICATION 结构的指针传递给 StatusIndication 参数。

注意 过分驱动程序可以使用 NDIS_STATUS_RECEIVE_FILTER_CURRENT_CAPABILITIES 状态指示来确定当前启用的网络适配器的接收筛选器功能。 或者,这些驱动程序还可以发出 OID_RECEIVE_FILTER_CURRENT_CAPABILITIES 的 OID 查询请求,以随时获取当前启用的接收筛选器功能。

要求

版本

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

标头

Ndis.h (包括 Ndis.h)

另请参阅


NdisMIndicateStatusEx

NDIS_STATUS_INDICATION

NDIS_RECEIVE_FILTER_CAPABILITIES

OID_RECEIVE_FILTER_CURRENT_CAPABILITIES