NDIS_STATUS_RECEIVE_FILTER_QUEUE_PARAMETERS

NDIS_STATUS_RECEIVE_FILTER_QUEUE_PARAMETERS状态向 NDIS 和超载驱动程序指示网络适配器上的当前虚拟机 (VM) 队列参数已更改。

注解

当网络适配器上的当前 VM 队列参数发生更改时,微型端口驱动程序必须发出 NDIS_STATUS_RECEIVE_FILTER_QUEUE_PARAMETERS 状态指示。 当以下条件之一为 true 时,VM 队列参数可能会更改:

  • VM 队列参数通过独立硬件供应商 (IHV) 开发的管理应用程序进行更改。

  • 对于属于负载均衡故障转移 (LBFO) 组(由 MUX 中间驱动程序管理)的一个或多个网络适配器,VM 队列参数会更改。 有关详细信息,请参阅 NDIS MUX 中间驱动程序

当微型端口驱动程序发出 NDIS_STATUS_RECEIVE_FILTER_QUEUE_PARAMETERS 状态指示时,它必须按照以下步骤操作:

  1. 微型端口驱动程序使用网络适配器上的当前 VM 队列参数初始化 NDIS_RECEIVE_QUEUE_PARAMETERS 结构。 驱动程序还必须使用相应的 NDIS_RECEIVE_QUEUE_PARAMETERS_Xxx_CHANGED 标志设置此结构的 Flags 成员,以报告已更改NDIS_RECEIVE_QUEUE_PARAMETERS成员值。

    注意 从 NDIS 6.30 开始,微型端口驱动程序只能发出 NDIS_STATUS_RECEIVE_FILTER_QUEUE_PARAMETERS 状态指示来报告 对 InterruptCoalescingDomainId 成员的更改。

当微型端口驱动程序初始化此结构的 Header 成员时,它会将 HeaderType 成员设置为NDIS_OBJECT_TYPE_DEFAULT。 微型端口驱动程序将 HeaderRevision 成员设置为 NDIS_RECEIVE_QUEUE_PARAMETERS_REVISION_2 并将 Size 成员设置为 NDIS_SIZEOF_RECEIVE_QUEUE_PARAMETERS_REVISION_2。

  1. 微型端口驱动程序按以下方式初始化 NDIS_STATUS_INDICATION 结构:

    • StatusCode 成员必须设置为 NDIS_STATUS_RECEIVE_FILTER_QUEUE_PARAMETERS

    • StatusBuffer 成员必须设置为指向NDIS_RECEIVE_QUEUE_PARAMETERS结构的指针。 此结构包含当前启用的 NIC 交换机的硬件功能。

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

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

过度使用的驱动程序可以使用 NDIS_STATUS_RECEIVE_FILTER_QUEUE_PARAMETERS 状态指示来确定网络适配器上的当前 VM 队列参数。 或者,这些驱动程序还可以发出对象标识符 (OID) 查询请求OID_RECEIVE_FILTER_QUEUE_PARAMETERS ,以随时获取这些参数。

要求

版本

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

标头

Ndis.h

另请参阅


NDIS_RECEIVE_QUEUE_PARAMETERS

NDIS_STATUS_INDICATION

OID_RECEIVE_FILTER_QUEUE_PARAMETERS