NDIS_RECEIVE_SCALE_PARAMETERS_V2 結構 (ntddndis.h)

警告

本主題中的某些資訊與發行前產品有關，在正式發行前可能會大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

RSSv2 僅在 Windows 10 1803 版中是預覽版。

NDIS_RECEIVE_SCALE_PARAMETERS_V2 結構會針對公告 RSS 第 2 版 (RSSv2 ) 支援的迷你埠配接器，指定接收端調整 (RSS) 參數。 它用於 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 成員設定為 sizeof (NDIS_RECEIVE_SCALE_PARAMETERS_V2) 。

Flags

ULONG 值，指出要變更的參數。 驅動程式可以使用這些旗標，快速判斷哪些參數已變更並據以更新 RSS 設定。

在查詢要求中，將此成員設定為零。

在集合要求中，旗標的定義如下：

值	意義
NDIS_RECEIVE_SCALE_PARAM_ENABLE_RSS	值為 1 表示指定的物件已啟用 RSS。 迷你埠驅動程序必須查看其他參數。 值為 0 表示指定物件的 RSS 已停用。 當 RSS 停用時， NumberOfQueues 和 NumberOfIndirectionTableEntries 參數可能會變更。 停用 RSS 時，應該忽略 HashInformation 和 HashKey 等其他參數。
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 (間接數據表項目數目。 這個值是兩個的乘冪，而且不會超過對應的配接器功能。 您可以在啟用 RSS 之前或之後變更。

此參數的新值也是兩個的乘冪，而且會超過配接器功能。 增加此數目時，迷你埠驅動程式應該視需要將目前的間接數據表複製到新的 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

RSS 第 2 版 (RSSv2)