NdisGetRssProcessorInformation, fonction (ndis.h)

Article
02/26/2024

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