NDIS_RECEIVE_SCALE_PARAMETERS_V2 结构 (ntddndis.h)

警告

本主题中的有些信息与预发布产品相关,该产品在商业发行之前可能发生重大更改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。

RSSv2 仅在 Windows 10 版本 1803 中提供预览版。

NDIS_RECEIVE_SCALE_PARAMETERS_V2 结构为微型端口适配器指定接收方缩放 (RSS) 参数,该适配器播发对 RSS 版本 2 (RSSv2) 的支持。 它在 OID_GEN_RECEIVE_SCALE_PARAMETERS_V2 OID 中使用。

语法

typedef struct _NDIS_RECEIVE_SCALE_PARAMETERS_V2 {
  NDIS_OBJECT_HEADER Header;
  ULONG              Flags;
  ULONG              HashInformation;
  ULONG              HashSecretKeySize;
  ULONG              HashSecretKeyOffset;
  ULONG              NumberOfQueues;
  ULONG              NumberOfIndirectionTableEntries;
} NDIS_RECEIVE_SCALE_PARAMETERS_V2, *PNDIS_RECEIVE_SCALE_PARAMETERS_V2;

成员

Header

NDIS_RECEIVE_SCALE_PARAMETERS_V2 结构的NDIS_OBJECT_HEADER结构。 将 Header 指定的结构的 Type 成员设置为NDIS_OBJECT_TYPE_RSS_PARAMETERS_V2

对于 NDIS 6.80 及更高版本的驱动程序,请将 Revision 成员设置为 NDIS_RECEIVE_SCALE_PARAMETERS_V2_REVISION_1将 Size 成员设置为 size, (NDIS_RECEIVE_SCALE_PARAMETERS_V2)

Flags

一个 ULONG 值,该值指示要更改的参数。 驱动程序可以使用这些标志快速确定哪些参数已更改并相应地更新 RSS 设置。

在查询请求中,将此成员设置为零。

在设置的请求中,标志定义如下:

含义
NDIS_RECEIVE_SCALE_PARAM_ENABLE_RSS
值为 1 表示为指定的对象启用了 RSS。 微型端口驱动程序需要查看其他参数。

值为 0 表示为指定的对象禁用 RSS。 禁用 RSS 时, NumberOfQueuesNumberOfIndirectionTableEntries 参数可能会更改。 禁用 RSS 时,应忽略 HashInformationHashKey 等其他参数。

NDIS_RECEIVE_SCALE_PARAM_HASH_INFO_CHANGED
HashInformation 参数的值已更改。
NDIS_RECEIVE_SCALE_PARAM_HASH_KEY_CHANGED
HashSecretKey 成员的内容已更改。
NDIS_RECEIVE_SCALE_PARAM_NUMBER_OF_QUEUES_CHANGED
每个 VPort 的队列数已更改。
NDIS_RECEIVE_SCALE_PARAM_NUMBER_OF_ENTRIES_CHANGED
间接寻址表中的条目数已更改。

HashInformation

在设置的请求中,此成员是 NIC 应用于计算传入数据包的哈希值的哈希类型和哈希函数。 如果在 HashInformation 成员中指定的哈希函数为零,则禁用 RSS。

在查询请求中,此成员是 NIC 使用的哈希类型和哈希函数。

覆盖驱动程序和 NDIS 可以使用 NDIS_RSS_HASH_INFO_FROM_TYPE_AND_FUNC 宏将哈希类型和哈希函数合并到哈希信息中,并设置 HashInformation 成员。

微型端口驱动程序可以使用 NDIS_RSS_HASH_TYPE_FROM_HASH_INFO 宏从 HashInformation 获取哈希类型, 并使用NDIS_RSS_HASH_FUNC_FROM_HASH_INFO 宏获取哈希函数。

可以在启用 RSS 的同时或之后更改此参数。

HashSecretKeySize

哈希函数的密钥数组的大小(以字节为单位)。 NdisHashFunctionToeplitz 的数组大小为 40 个字节。

可以在启用 RSS 的同时或之后更改此参数。

HashSecretKeyOffset

哈希密钥的偏移量(以字节为单位)。

可以在启用 RSS 的同时或之后更改此参数。

NumberOfQueues

缩放实体的最大队列数。 此参数是 NDIS_NIC_SWITCH_VPORT_PARAMETERS 结构的 NUM_QUEUE_PAIRS 变量的别名,也可以通过 OID_NIC_SWITCH_VPORT_PARAMETERS OID 进行查询或设置。 启用或禁用 RSS 时,可以更改它。

NumberOfIndirectionTableEntries

缩放实体) (ITE 的间接表条目数。 此值为 2 的幂,不会超过相应适配器的功能。 可以在启用 RSS 之前或之后更改它。

此参数的新值也是 2 的幂,并且确实超过了适配器功能。 当此数字增加时,微型端口驱动程序应根据需要多次将当前间接表克隆到新的 ITE 中, (这一点由于) 的幂限制。 当此数字减少时,上层保证要移除的间接表部分包含剩余部分的确切副本。

要求

要求
最低受支持的客户端 在 NDIS 6.80 及更高版本中受支持。
标头 ntddndis.h (包括 Ndis.h)

另请参阅

NDIS_NIC_SWITCH_VPORT_PARAMETERS

NDIS_OBJECT_HEADER

NDIS_RSS_HASH_FUNC_FROM_HASH_INFO

NDIS_RSS_HASH_INFO_FROM_TYPE_AND_FUNC

NDIS_RSS_HASH_TYPE_FROM_HASH_INFO

OID_GEN_RECEIVE_SCALE_PARAMETERS_V2

OID_NIC_SWITCH_VPORT_PARAMETERS

RSSv2) (RSS 版本 2