NdisGetProcessorInformationEx, fonction (ndis.h)

Article
02/07/2025

La fonction NdisGetProcessorInformationEx récupère des informations sur la topologie du processeur de l’ordinateur local.

Syntaxe

NDIS_STATUS NdisGetProcessorInformationEx(
  [in, optional]  NDIS_HANDLE                    NdisHandle,
  [out, optional] PNDIS_SYSTEM_PROCESSOR_INFO_EX SystemProcessorInfo,
  [in, out]       PSIZE_T                        Size
);

Paramètres

[in, optional] NdisHandle

Pilote NDIS ou handle d’instance obtenu lors de l’initialisation de l’appelant. Par exemple, un pilote miniport peut utiliser le handle NDIS qu’il a obtenu à partir du fonctions NdisMRegisterMiniportDriver ou MiniportInitializeEx. D’autres pilotes NDIS peuvent utiliser les handles des fonctions suivantes :

NdisRegisterProtocolDriver

NdisOpenAdapterEx

NdisFRegisterFilterDriver

FilterAttach

[out, optional] SystemProcessorInfo

Pointeur vers une mémoire tampon allouée par l’appelant où NDIS place le NDIS_SYSTEM_PROCESSOR_INFO_EX structure et tableau de structures NDIS_PROCESSOR_INFO_EX qui contiennent des informations sur la topologie du processeur de l’ordinateur local. 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, cette valeur 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

NdisGetProcessorInformationEx pouvez retourner l’une des valeurs d’état suivantes :

Retourner le code	Description
NDIS_STATUS_SUCCESS	L’opération s’est terminée avec succès.
NDIS_STATUS_BUFFER_TOO_SHORT	La taille de la mémoire tampon au paramètre Size était trop petite. Dans ce cas, NDIS fournit la taille de mémoire tampon requise dans le membre Size.

Remarques

Les pilotes NDIS appellent la fonction NdisGetProcessorInformationEx pour récupérer des informations sur les processeurs sur l’ordinateur local.

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