NdisGetRssProcessorInformation, fonction (ndis.h)
La fonction NdisGetRssProcessorInformation récupère des informations sur l’ensemble des 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
Handle d’instance NDIS 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 par 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 processeurs 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 est retournée, 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 de retour
NdisGetRssProcessorInformation pouvez retourner l’une des valeurs d’état suivantes :
| Retourner le code | Description |
|---|---|
|
L’opération s’est terminée avec succès. |
|
La taille spécifiée dans 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 appel NdisGetRssProcessorInformation dans leur MiniportFilterResourceRequirements fonction. 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.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Pris en charge dans NDIS 6.20 et versions ultérieures. |
| plateforme cible | Universel |
| d’en-tête | ndis.h (include Ndis.h) |
| bibliothèque | Ndis.lib |
| IRQL | <= DISPATCH_LEVEL |