Funzione NdisGetProcessorInformationEx (ndis.h)

Articolo
03/08/2023

La funzione NdisGetProcessorInformationEx recupera informazioni sulla topologia 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 viene restituita, questo valore contiene la quantità di dati inseriti nel buffer o le dimensioni necessarie del buffer se il buffer è troppo breve.

Valore restituito

NdisGetProcessorInformationEx può restituire uno dei valori di stato seguenti:

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

Commenti

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

Requisiti

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