Funzione NdisGetRssProcessorInformation (ndis.h)

Articolo
02/26/2024

La funzione NdisGetRssProcessorInformation recupera informazioni sul set di processori che un driver miniport deve usare per ricevere il ridimensionamento laterale (RSS).

Sintassi

NDIS_STATUS NdisGetRssProcessorInformation(
  [in]            NDIS_HANDLE              NdisHandle,
  [out, optional] PNDIS_RSS_PROCESSOR_INFO RssProcessorInfo,
  [in, out]       PSIZE_T                  Size
);

Parametri

[in] NdisHandle

Handle di istanza NDIS ottenuto durante l'inizializzazione del chiamante. I driver NDIS possono usare gli handle delle funzioni seguenti:

MiniportInitializeEx

NdisOpenAdapterEx

[out, optional] RssProcessorInfo

Puntatore a un buffer allocato dal chiamante in cui NDIS inserisce la struttura NDIS_RSS_PROCESSOR_INFO e una matrice di strutture NDIS_RSS_PROCESSOR che contengono informazioni sul set di processori RSS. Il chiamante fornisce la lunghezza del buffer nel parametro Size .

[in, out] Size

Puntatore a un valore che corrisponde alla dimensione, in byte, del buffer fornito dal chiamante. Quando la funzione viene restituita, questo membro contiene la quantità di dati inseriti nel buffer o le dimensioni necessarie del buffer se il buffer era troppo breve.

Valore restituito

NdisGetRssProcessorInformation può restituire uno dei valori di stato seguenti:

Codice restituito	Descrizione
NDIS_STATUS_SUCCESS	Operazione riuscita.
NDIS_STATUS_BUFFER_TOO_SHORT	Le dimensioni specificate nel parametro Size sono troppo piccole. In questo caso, NDIS fornisce le dimensioni del buffer necessarie nel parametro Size .

Commenti

I driver NDIS chiamano la funzione NdisGetRssProcessorInformation per recuperare informazioni sui processori RSS (Receive Side Scaling) nel computer locale.

Driver miniport compatibili con RSS che supportano MSI-X chiamano NdisGetRssProcessorInformation nei relativi Funzione MiniportFilterResourceRequirements . I driver Miniport impostano l'affinità di interruzione dei messaggi MSI-X allocati ai processori RSS specificati nel membro RssProcessors del parametro RssProcessorInfo .

Requisiti

Requisito	Valore
Client minimo supportato	Supportato in NDIS 6.20 e versioni successive.
Piattaforma di destinazione	Universale
Intestazione	ndis.h (include Ndis.h)
Libreria	Ndis.lib
IRQL	<= DISPATCH_LEVEL

Vedi anche

MiniportFilterResourceRequirements