Funzione NdisGetProcessorInformationEx (ndis.h)

Articolo
02/07/2025

La funzione NdisGetProcessorInformationEx recupera informazioni sulla topologia DELLA CPU del computer locale.

Sintassi

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

Parametri

[in, optional] NdisHandle

Handle di istanza o driver NDIS ottenuto durante l'inizializzazione del chiamante. Ad esempio, un driver miniport può usare l'handle NDIS ottenuto dal funzioni NdisMRegisterMiniportDriver o miniportInitializeEx. Altri driver NDIS possono usare gli handle delle funzioni seguenti:

NdisRegisterProtocolDriver

NdisOpenAdapterEx

NdisFRegisterFilterDriver

FilterAttach

[out, optional] SystemProcessorInfo

Puntatore a un buffer allocato dal chiamante in cui NDIS inserisce NDIS_SYSTEM_PROCESSOR_INFO_EX struttura e una matrice di strutture NDIS_PROCESSOR_INFO_EX che contengono informazioni sulla topologia della CPU del computer locale. Il chiamante fornisce la lunghezza del buffer nel parametro Size.

[in, out] Size

Puntatore a un valore che corrisponde alla dimensione, in byte, del buffer fornito dal chiamante. Quando la funzione termina, questo valore contiene la quantità di dati inseriti nel buffer o le dimensioni necessarie del buffer se il buffer era troppo breve.

Valore restituito

NdisGetProcessorInformationEx può restituire uno dei valori di stato seguenti:

Codice restituito	Descrizione
NDIS_STATUS_SUCCESS	Operazione completata correttamente.
NDIS_STATUS_BUFFER_TOO_SHORT	Le dimensioni del buffer in corrispondenza del parametro size erano troppo piccole. In questo caso, NDIS fornisce le dimensioni del buffer necessarie nel membro Size.

Osservazioni

I driver NDIS chiamano la funzione NdisGetProcessorInformationEx per recuperare informazioni sui processori nel computer locale.

Fabbisogno

Requisito	Valore
client minimo supportato	Supportato in NDIS 6.20 e versioni successive.
piattaforma di destinazione	Universale
intestazione	ndis.h (include Ndis.h)
libreria	Ndis.lib
IRQL	<= DISPATCH_LEVEL