Partager via


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 :

MiniportInitializeEx

NdisOpenAdapterEx

[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
NDIS_STATUS_SUCCESS
L’opération s’est terminée avec succès.
NDIS_STATUS_BUFFER_TOO_SHORT
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

Voir aussi

MiniportFilterResourceRequirements

MiniportInitializeEx

NDIS_RSS_PROCESSOR

NDIS_RSS_PROCESSOR_INFO

NdisOpenAdapterEx