структура NDIS_RECEIVE_SCALE_PARAMETERS_V2 (ntddndis.h)

Статья
08/07/2023

Предупреждение

Некоторые сведения в этом разделе относятся к предварительно выпущенной продукции, которая может быть существенно изменена до его коммерческого выпуска. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

ВЕРСИЯ 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_OBJECT_HEADER для структуры NDIS_RECEIVE_SCALE_PARAMETERS_V2 . Задайте для элемента 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 отключен для указанного объекта. Параметры NumberOfQueues и NumberOfIndirectionTableEntries могут изменяться при отключении RSS. При отключении 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

В запросе набора этот член является хэш-типом и хэш-функцией, которую сетевой адаптер должен использовать для вычисления хэш-значений для входящих пакетов. Если хэш-функция, указанная в элементе HashInformation , равна нулю, RSS отключена.

В запросе запроса этот член является хэш-типом и хэш-функцией, которые использует сетевой адаптер.

Драйверы overlying и 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

Размер массива секретных ключей хэш-функции в байтах. Размер массива составляет 40 байт для NdisHashFunctionToeplitz.

Этот параметр можно изменить одновременно с включением RSS или после этого.

HashSecretKeyOffset

Смещение (в байтах) секретного ключа хэша.

Этот параметр можно изменить одновременно с включением RSS или после этого.

NumberOfQueues

Максимальное количество очередей для масштабируемой сущности. Этот параметр является псевдонимом для переменной NUM_QUEUE_PAIRS структуры NDIS_NIC_SWITCH_VPORT_PARAMETERS , которую также можно запрашивать или задавать с помощью OID_NIC_SWITCH_VPORT_PARAMETERS OID. Его можно изменить при включении или отключении RSS.

NumberOfIndirectionTableEntries

Количество записей таблицы косвенного обращения (ITE) для масштабируемой сущности. Это значение равно двум и не превышает возможности соответствующего адаптера. Его можно изменить до включения RSS или позже.

Новые значения для этого параметра также имеют два значения и превышают возможности адаптера. При увеличении этого числа драйвер мини-порта должен клонировать текущую таблицу косвенного обращения в новые ИТ-среды столько раз, сколько это необходимо (это возможно из-за ограничения мощности двух). При уменьшении этого числа верхний слой гарантирует, что часть удаляемой таблицы косвенного обращения содержит точные реплики оставшейся части.

Требования

Требование	Значение
Минимальная версия клиента	Поддерживается в NDIS 6.80 и более поздних версиях.
Верхняя часть	ntddndis.h (включая Ndis.h)