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 状态指示时,它必须按照以下步骤操作:
微型端口驱动程序使用网络适配器上的当前 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 成员时,它会将 Header 的 Type 成员设置为NDIS_OBJECT_TYPE_DEFAULT。 微型端口驱动程序将 Header 的 Revision 成员设置为 NDIS_RECEIVE_QUEUE_PARAMETERS_REVISION_2 并将 Size 成员设置为 NDIS_SIZEOF_RECEIVE_QUEUE_PARAMETERS_REVISION_2。
微型端口驱动程序按以下方式初始化 NDIS_STATUS_INDICATION 结构:
StatusCode 成员必须设置为 NDIS_STATUS_RECEIVE_FILTER_QUEUE_PARAMETERS。
StatusBuffer 成员必须设置为指向NDIS_RECEIVE_QUEUE_PARAMETERS结构的指针。 此结构包含当前启用的 NIC 交换机的硬件功能。
StatusBufferSize 成员必须设置为 sizeof (NDIS_RECEIVE_QUEUE_PARAMETERS) 。
微型端口驱动程序通过调用 NdisMIndicateStatusEx 发出状态通知。 驱动程序必须将指向 NDIS_STATUS_INDICATION 结构的指针传递给 StatusIndication 参数。
过度使用的驱动程序可以使用 NDIS_STATUS_RECEIVE_FILTER_QUEUE_PARAMETERS 状态指示来确定网络适配器上的当前 VM 队列参数。 或者,这些驱动程序还可以发出对象标识符 (OID) 查询请求OID_RECEIVE_FILTER_QUEUE_PARAMETERS ,以随时获取这些参数。
要求
版本 |
在 NDIS 6.30 及更高版本中受支持。 |
标头 |
Ndis.h |