NDIS_RECEIVE_SCALE_PARAMETERS_V2 struttura (ntddndis.h)

Articolo
08/07/2023

Avviso

Alcune informazioni in questo argomento si riferiscono al prodotto non rilasciato, che può essere modificato sostanzialmente prima che venga rilasciato commercialmente. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

RSSv2 è in anteprima solo in Windows 10 versione 1803.

La struttura NDIS_RECEIVE_SCALE_PARAMETERS_V2 specifica i parametri Receive Side Scaling (RSS) per una scheda 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;

Members

Header

Struttura NDIS_OBJECT_HEADER per la struttura NDIS_RECEIVE_SCALE_PARAMETERS_V2 . Impostare il membro Type della struttura specificata dall'intestazione su NDIS_OBJECT_TYPE_RSS_PARAMETERS_V2.

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

Flags

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

In una richiesta di query impostare questo membro su zero.

In una richiesta impostata i flag sono 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 parametri NumberOfQueues e NumberOfIndirectionTableEntries 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 è cambiato.
NDIS_RECEIVE_SCALE_PARAM_NUMBER_OF_ENTRIES_CHANGED	Il numero di voci nella tabella di indiretto è cambiato.

HashInformation

In una richiesta impostata, 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 è disabilitata.

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. Le dimensioni della matrice sono 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ò essere eseguita anche query o impostata tramite l'OID OID_NIC_SWITCH_VPORT_PARAMETERS. Può essere modificato quando RSS è abilitato o disabilitato.

NumberOfIndirectionTableEntries

Numero di voci di tabella indirette (ITE) per l'entità di ridimensionamento. Questo valore è una potenza di due e non supera le funzionalità dell'adattatore corrispondente. Può essere modificato 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 è aumentato, il driver miniport deve clonare la tabella di indiretto corrente nelle nuove ITE quante volte necessario (questo è possibile a causa della restrizione di alimentazione di due). Quando questo numero viene ridotto, il livello superiore garantisce che la parte della tabella indiretta che viene rimossa contiene repliche esatte della parte rimanente.