NDIS_RECEIVE_SCALE_PARAMETERS_V2 estrutura (ntddndis.h)

Artigo
02/07/2025

Aviso

Algumas informações neste tópico referem-se ao produto pré-relacionado, que pode ser substancialmente modificado antes de ser lançado comercialmente. A Microsoft não oferece garantias, expressas ou implícitas, em relação às informações fornecidas aqui.

O RSSv2 é visualizado apenas no Windows 10, versão 1803.

A estrutura NDIS_RECEIVE_SCALE_PARAMETERS_V2 especifica os parâmetros RSS (Receive Side Scaling) para um adaptador de miniporto que anuncia o suporte para RSS Versão 2 (RSSv2). Ele é usado na OID OID_GEN_RECEIVE_SCALE_PARAMETERS_V2.

Sintaxe

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;

Membros

Header

A estrutura NDIS_OBJECT_HEADER para a estrutura NDIS_RECEIVE_SCALE_PARAMETERS_V2. Defina o Type membro da estrutura que de cabeçalho especifica para NDIS_OBJECT_TYPE_RSS_PARAMETERS_V2.

Para drivers NDIS 6.80 e posteriores, defina o membro de Revisão como NDIS_RECEIVE_SCALE_PARAMETERS_V2_REVISION_1 e o membro tamanho do para sizeof(NDIS_RECEIVE_SCALE_PARAMETERS_V2).

Flags

Um ulong valor que indica quais parâmetros estão sendo alterados. O driver pode usar esses sinalizadores para determinar rapidamente quais parâmetros foram alterados e atualizar as configurações do RSS adequadamente.

Em uma solicitação de consulta, defina esse membro como zero.

Em uma solicitação definida, os sinalizadores são definidos da seguinte maneira:

Valor	Significado
NDIS_RECEIVE_SCALE_PARAM_ENABLE_RSS	Um valor de 1 indica que o RSS está habilitado para o objeto especificado. O driver de miniporto precisa examinar outros parâmetros. Um valor de 0 indica que o RSS está desabilitado para o objeto especificado. Os parâmetros NumberOfQueues e NumberOfIndirectionTableEntries podem ser alterados quando o RSS está desabilitado. Outros parâmetros, como HashInformation e HashKey, devem ser ignorados quando o RSS estiver desabilitado.
NDIS_RECEIVE_SCALE_PARAM_HASH_INFO_CHANGED	O valor do parâmetro HashInformation foi alterado.
NDIS_RECEIVE_SCALE_PARAM_HASH_KEY_CHANGED	O conteúdo do membro HashSecretKey foi alterado.
NDIS_RECEIVE_SCALE_PARAM_NUMBER_OF_QUEUES_CHANGED	O número de filas por VPort foi alterado.
NDIS_RECEIVE_SCALE_PARAM_NUMBER_OF_ENTRIES_CHANGED	O número de entradas na tabela de indireção foi alterado.

HashInformation

Em uma solicitação definida, esse membro é o tipo de hash e a função de hash que a NIC deve usar para calcular os valores de hash para os pacotes de entrada. Se a função de hash especificada no membro HashInformation for zero, o RSS será desabilitado.

Em uma solicitação de consulta, esse membro é o tipo de hash e a função de hash que a NIC está usando.

Drivers e NDIS em excesso podem usar a macro NDIS_RSS_HASH_INFO_FROM_TYPE_AND_FUNC para combinar o tipo de hash e a função de hash em informações de hash e definir o membro HashInformation.

Os drivers de miniport podem usar a macro NDIS_RSS_HASH_TYPE_FROM_HASH_INFO para obter o tipo de hash do hashInformation e da macro NDIS_RSS_HASH_FUNC_FROM_HASH_INFO para obter a função de hash.

Esse parâmetro pode ser alterado ao mesmo tempo em que o RSS está habilitado ou posterior.

HashSecretKeySize

O tamanho da matriz de chaves secretas da função hash, em bytes. O tamanho da matriz é de 40 bytes para NdisHashFunctionToeplitz.

Esse parâmetro pode ser alterado ao mesmo tempo em que o RSS está habilitado ou posterior.

HashSecretKeyOffset

O deslocamento, em bytes, da chave secreta de hash.

Esse parâmetro pode ser alterado ao mesmo tempo em que o RSS está habilitado ou posterior.

NumberOfQueues

O número máximo de filas para a entidade de dimensionamento. Esse parâmetro é um alias para a variável NUM_QUEUE_PAIRS da estrutura NDIS_NIC_SWITCH_VPORT_PARAMETERS, que também pode ser consultada ou definida por meio do OID OID_NIC_SWITCH_VPORT_PARAMETERS. Ele pode ser alterado quando o RSS está habilitado ou desabilitado.

NumberOfIndirectionTableEntries

O número de ITEs (entradas de tabela de indireção) para a entidade de dimensionamento. Esse valor é uma potência de dois e não excede os recursos do adaptador correspondente. Ele pode ser alterado antes do RSS ser habilitado ou posterior.

Novos valores para esse parâmetro também são uma potência de dois e excedem os recursos do adaptador. Quando esse número for aumentado, o driver de miniporto deverá clonar a tabela de indireção atual nos novos ITEs quantas vezes forem necessários (isso é possível devido à restrição de potência de dois). Quando esse número é reduzido, a camada superior garante que a parte da tabela de indireção que está sendo removida contenha réplicas exatas da parte restante.