NDIS_STATUS_RECEIVE_FILTER_CURRENT_CAPABILITIES
微型端口驱动程序在当前启用的接收筛选功能发生更改时发出 NDIS_STATUS_RECEIVE_FILTER_CURRENT_CAPABILITIES 状态指示。
注意 此状态指示只能由支持 NDIS 接收筛选器的微型端口驱动程序进行。
当微型端口驱动程序发出此状态指示时,它会将 NDIS_STATUS_INDICATION 结构的 StatusBuffer 成员设置为指向NDIS_RECEIVE_FILTER_CAPABILITIES结构的指针。 驱动程序使用其当前启用的接收筛选器功能初始化此结构。
注解
NDIS 接收筛选器用于以下 NDIS 接口:
NDIS 数据包合并。 有关如何在此接口中使用接收筛选器的详细信息,请参阅 管理数据包合并接收筛选器。
单根 I/O 虚拟化 (SR-IOV) 。 有关如何在此接口中使用接收筛选器的详细信息,请参阅 在虚拟端口上设置接收筛选器。
虚拟机队列 (VMQ)。 有关如何在此接口中使用接收筛选器的详细信息,请参阅 设置和清除 VMQ 筛选器。
满足以下条件之一时,微型端口驱动程序会发出 NDIS_STATUS_RECEIVE_FILTER_CURRENT_CAPABILITIES 状态指示:
当前启用的接收筛选器功能在单个网络适配器上发生更改。 例如,可以通过独立硬件供应商 (IHV) 开发的管理应用程序启用或禁用接收筛选器。
当前启用的接收筛选器功能会更改属于负载均衡故障转移 (LBFO) 由 MUX 中间驱动程序管理的一个或多个网络适配器。 有关详细信息,请参阅 NDIS MUX 中间驱动程序。
微型端口驱动程序在发出 NDIS_STATUS_RECEIVE_FILTER_CURRENT_CAPABILITIES 状态指示时遵循以下步骤:
微型端口使用网络适配器上当前启用的接收筛选器功能初始化 NDIS_RECEIVE_FILTER_CAPABILITIES 结构。
微型端口驱动程序初始化 Header 成员时,会将 Header 的 Type 成员设置为 NDIS_OBJECT_TYPE_DEFAULT。 微型端口驱动程序将 Header 的 Revision 成员设置为 NDIS_RECEIVE_FILTER_CAPABILITIES_REVISION_2,将 Size 成员设置为 NDIS_SIZEOF_RECEIVE_FILTER_CAPABILITIES_REVISION_2。
微型端口驱动程序通过以下方式初始化状态指示的 NDIS_STATUS_INDICATION 结构:
StatusCode 成员必须设置为 NDIS_STATUS_RECEIVE_FILTER_CURRENT_CAPABILITIES。
StatusBuffer 成员必须设置为 NDIS_RECEIVE_FILTER_CAPABILITIES 结构的地址。
StatusBufferSize 成员必须设置为
sizeof(NDIS_RECEIVE_FILTER_CAPABILITIES)
。
微型端口驱动程序通过调用 NdisMIndicateStatusEx 发出状态指示。 驱动程序必须将指向 NDIS_STATUS_INDICATION 结构的指针传递给 StatusIndication 参数。
注意 过分驱动程序可以使用 NDIS_STATUS_RECEIVE_FILTER_CURRENT_CAPABILITIES 状态指示来确定当前启用的网络适配器的接收筛选器功能。 或者,这些驱动程序还可以发出 OID_RECEIVE_FILTER_CURRENT_CAPABILITIES 的 OID 查询请求,以随时获取当前启用的接收筛选器功能。
要求
版本 |
在 NDIS 6.30 及更高版本中受支持。 |
标头 |
Ndis.h (包括 Ndis.h) |