Funzione NdisGetRssProcessorInformation (ndis.h)
La funzione NdisGetRssProcessorInformation recupera informazioni sul set di processori che un driver miniport deve usare per il ridimensionamento lato ricezione (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 dalle funzioni seguenti:
[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 termina, 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 |
|---|---|
|
Operazione completata correttamente. |
|
Le dimensioni specificate nel parametro Size erano troppo piccole. In questo caso, NDIS fornisce le dimensioni del buffer necessarie nel parametro Size. |
Osservazioni
I driver NDIS chiamano la funzione NdisGetRssProcessorInformation per recuperare informazioni sui processori RSS (Receive Side Scaling) nel computer locale.
Driver miniport che supportano RSS che supportano MSI-X chiamare NdisGetRssProcessorInformation nel relativo funzione MiniportFilterResourceRequirements. I driver Miniport impostano l'affinità di interruzione dei messaggi MSI-X allocati ai processori RSS specificati nel RssProcessors membro del parametro RssProcessorInfo.
Fabbisogno
| 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 |