struttura NDIS_RECEIVE_SCALE_PARAMETERS_V2 (ntddndis.h)

Articolo
02/07/2025

Avvertimento

Alcune informazioni contenute in questo argomento riguardano il prodotto non definitiva, che potrebbe essere modificato in modo sostanziale prima che venga rilasciato commercialmente. Microsoft non fornisce alcuna garanzia, espressa o implicita, in relazione alle informazioni fornite qui.

RSSv2 è disponibile in anteprima solo in Windows 10 versione 1803.

La struttura NDIS_RECEIVE_SCALE_PARAMETERS_V2 specifica i parametri RSS (Receive Side Scaling) per un adattatore miniport che annuncia il supporto per RSS Versione 2 (RSSv2). Viene usato nell'OID OID_GEN_RECEIVE_SCALE_PARAMETERS_V2.

Sintassi

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;

Membri

Header

Struttura NDIS_OBJECT_HEADER per la struttura NDIS_RECEIVE_SCALE_PARAMETERS_V2. Impostare il membro type della struttura che header specifica su NDIS_OBJECT_TYPE_RSS_PARAMETERS_V2.

Per i driver NDIS 6.80 e versioni successive, impostare il membro revisione su NDIS_RECEIVE_SCALE_PARAMETERS_V2_REVISION_1 e il membro dimensioni su sizeof(NDIS_RECEIVE_SCALE_PARAMETERS_V2).

Flags

Valore di ULONG che indica quali parametri vengono modificati. Il driver può usare questi flag per determinare rapidamente quali parametri sono stati modificati e aggiornare le impostazioni RSS di conseguenza.

In una richiesta di query impostare questo membro su zero.

In una richiesta set, i flag vengono definiti come segue:

Valore	Significato
NDIS_RECEIVE_SCALE_PARAM_ENABLE_RSS	Il valore 1 indica che RSS è abilitato per l'oggetto specificato. Il driver miniport deve esaminare altri parametri. Il valore 0 indica che RSS è disabilitato per l'oggetto specificato. I NumberOfQueues e NumberOfIndirectionTableEntries parametri possono cambiare quando RSS è disabilitato. Altri parametri come HashInformation e HashKey devono essere ignorati quando RSS è disabilitato.
NDIS_RECEIVE_SCALE_PARAM_HASH_INFO_CHANGED	Il valore del parametro HashInformation è stato modificato.
NDIS_RECEIVE_SCALE_PARAM_HASH_KEY_CHANGED	Il contenuto del membro HashSecretKey è stato modificato.
NDIS_RECEIVE_SCALE_PARAM_NUMBER_OF_QUEUES_CHANGED	Il numero di code per VPort è stato modificato.
NDIS_RECEIVE_SCALE_PARAM_NUMBER_OF_ENTRIES_CHANGED	Il numero di voci nella tabella di riferimento indiretto è stato modificato.

HashInformation

In una richiesta set, questo membro è il tipo hash e la funzione hash che la scheda di interfaccia di rete deve usare per calcolare i valori hash per i pacchetti in ingresso. Se la funzione hash specificata all'interno del membro HashInformation è zero, RSS è disabilitato.

In una richiesta di query, questo membro è il tipo hash e la funzione hash usata dalla scheda di interfaccia di rete.

Gli overlying driver e NDIS possono usare la macro NDIS_RSS_HASH_INFO_FROM_TYPE_AND_FUNC per combinare il tipo hash e la funzione hash in informazioni hash e impostare il membro HashInformation.

I driver Miniport possono usare la macro NDIS_RSS_HASH_TYPE_FROM_HASH_INFO per ottenere il tipo hash da HashInformation e la macro NDIS_RSS_HASH_FUNC_FROM_HASH_INFO per ottenere la funzione hash.

Questo parametro può essere modificato contemporaneamente all'abilitazione di RSS o successivamente.

HashSecretKeySize

Dimensioni della matrice di chiavi segrete della funzione hash, in byte. La dimensione della matrice è di 40 byte per NdisHashFunctionToeplitz.

Questo parametro può essere modificato contemporaneamente all'abilitazione di RSS o successivamente.

HashSecretKeyOffset

Offset, in byte, della chiave privata hash.

Questo parametro può essere modificato contemporaneamente all'abilitazione di RSS o successivamente.

NumberOfQueues

Numero massimo di code per l'entità di ridimensionamento. Questo parametro è un alias per la variabile NUM_QUEUE_PAIRS della struttura NDIS_NIC_SWITCH_VPORT_PARAMETERS, che può anche essere sottoposta a query o impostata tramite l'OID OID_NIC_SWITCH_VPORT_PARAMETERS. Può essere modificato quando RSS è abilitato o disabilitato.

NumberOfIndirectionTableEntries

Numero di voci della tabella di riferimento indiretto (ITE) per l'entità di ridimensionamento. Questo valore è una potenza di due e non supera le funzionalità dell'adattatore corrispondente. Può essere modificato in corrispondenza di prima che RSS sia abilitato o successivamente.

I nuovi valori per questo parametro sono anche una potenza di due e superano le funzionalità dell'adattatore. Quando questo numero viene aumentato, il driver miniport deve clonare la tabella di riferimento indiretto corrente nei nuovi ite il maggior numero di volte necessario (ciò è possibile a causa della potenza di due restrizioni). Quando questo numero viene ridotto, il livello superiore garantisce che la parte della tabella di riferimento indiretto che viene rimossa contenga repliche esatte della parte rimanente.