NdisGetProcessorInformationEx, fonction (ndis.h)

Article
02/27/2024

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

Un pilote NDIS ou un instance handle 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 un 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 retourne, 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 retournée

NdisGetProcessorInformationEx 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 de la mémoire tampon au niveau du 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.

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