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 结构。 设置 标头 指定为 NDIS_OBJECT_TYPE_RSS_PARAMETERS_V2的结构 类型 成员。

对于 NDIS 6.80 及更高版本的驱动程序,请将 修订版 成员设置为 NDIS_RECEIVE_SCALE_PARAMETERS_V2_REVISION_1,并将 大小 成员设置为 sizeof(NDIS_RECEIVE_SCALE_PARAMETERS_V2)

Flags

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

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

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

价值 意义
NDIS_RECEIVE_SCALE_PARAM_ENABLE_RSS
值为 1 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 宏从 HashInformationNDIS_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)。 此值是两个电源,不会超过相应的适配器的功能。 可以在启用 RSS 之前或之后更改它。

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

要求

要求 价值
最低支持的客户端 在 NDIS 6.80 及更高版本中受支持。
标头 ntddndis.h (include 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

RSS 版本 2 (RSSv2)