NdisGetRssProcessorInformation, fonction (ndis.h)
La fonction NdisGetRssProcessorInformation récupère des informations sur l’ensemble de processeurs qu’un pilote miniport doit utiliser pour la mise à l’échelle côté réception (RSS).
Syntaxe
NDIS_STATUS NdisGetRssProcessorInformation(
[in] NDIS_HANDLE NdisHandle,
[out, optional] PNDIS_RSS_PROCESSOR_INFO RssProcessorInfo,
[in, out] PSIZE_T Size
);
Paramètres
[in] NdisHandle
Un handle NDIS instance obtenu lors de l’initialisation de l’appelant. Les pilotes NDIS peuvent utiliser les handles des fonctions suivantes :
[out, optional] RssProcessorInfo
Pointeur vers une mémoire tampon allouée à l’appelant où NDIS place la structure NDIS_RSS_PROCESSOR_INFO et un tableau de structures NDIS_RSS_PROCESSOR qui contiennent des informations sur le jeu de processeur RSS. L’appelant fournit la longueur de la mémoire tampon dans le paramètre Size .
[in, out] Size
Pointeur vers une valeur qui correspond à la taille, en octets, de la mémoire tampon fournie par l’appelant. Lorsque la fonction retourne, ce membre contient la quantité de données que NDIS a placées dans la mémoire tampon ou la taille requise de la mémoire tampon si la mémoire tampon était trop courte.
Valeur retournée
NdisGetRssProcessorInformation peut retourner l’une des valeurs status suivantes :
| Code de retour | Description |
|---|---|
|
L’opération s’est terminée avec succès. |
|
La taille spécifiée dans le paramètre Size était trop petite. Dans ce cas, NDIS fournit la taille de mémoire tampon requise dans le paramètre Size . |
Remarques
Les pilotes NDIS appellent la fonction NdisGetRssProcessorInformation pour récupérer des informations sur les processeurs de mise à l’échelle côté réception (RSS) sur l’ordinateur local.
Pilotes miniport compatibles RSS qui prennent en charge MSI-X appellent NdisGetRssProcessorInformation dans leur Fonction MiniportFilterResourceRequirements . Les pilotes Miniport définissent l’affinité d’interruption des messages MSI-X alloués aux processeurs RSS spécifiés dans le membre RssProcessors du paramètre RssProcessorInfo .
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Pris en charge dans NDIS 6.20 et versions ultérieures. |
| Plateforme cible | Universal |
| En-tête | ndis.h (inclure Ndis.h) |
| Bibliothèque | Ndis.lib |
| IRQL | <= DISPATCH_LEVEL |