Condividi tramite


Funzione KeQueryMaximumProcessorCountEx (wdm.h)

La routine KeQueryMaximumProcessorCountEx restituisce il numero massimo di processori logici in un gruppo specificato in un sistema multiprocessore.

Sintassi

ULONG KeQueryMaximumProcessorCountEx(
  [in] USHORT GroupNumber
);

Parametri

[in] GroupNumber

Specifica un numero di gruppo. Se un sistema multiprocessore contiene n gruppi, i gruppi vengono numerati da 0 a n-1. Per ottenere il numero massimo di processori nel sistema, impostare questo parametro su ALL_PROCESSOR_GROUPS, definito nei file di intestazione Winnt.h e Ntdef.h.

Valore restituito

KeQueryMaximumProcessorCountEx restituisce il numero massimo di processori logici nel gruppo specificato o nel sistema, come indicato dal valore del parametro GroupNumber .

Commenti

Il valore restituito da KeQueryMaximumProcessorCountEx rimane costante durante il runtime. Questo valore dipende dalla configurazione hardware del sistema multiprocessore, ma non può mai superare un limite fisso impostato dal sistema operativo Windows. Questo limite è di 32 processori logici per le versioni a 32 bit di Windows e 64 processori logici per le versioni a 64 bit di Windows.

Al contrario, il valore restituito dalla routine KeQueryActiveProcessorCountEx può cambiare durante il runtime man mano che i processori vengono aggiunti dinamicamente al sistema.

Una routine correlata, KeQueryMaximumProcessorCount, restituisce un numero massimo di processori, ma questa routine, diversamente da KeQueryMaximumProcessorCountEx, non accetta un numero di gruppo come parametro di input. In Windows 7 e versioni successive del sistema operativo Windows , KeQueryMaximumProcessorCount restituisce il numero massimo di processori logici nel gruppo 0, che è compatibile con il comportamento di questa routine nelle versioni precedenti di Windows che non supportano i gruppi. Questo comportamento garantisce che i driver esistenti che chiamano KeQueryMaximumProcessorCount e che non usino funzionalità orientate ai gruppi vengano eseguite correttamente nei sistemi multiprocessore con due o più gruppi. Tuttavia, i driver che usano funzionalità orientate ai gruppi in Windows 7 e versioni successive del sistema operativo Windows devono chiamare KeQueryMaximumProcessorCountEx anziché KeQueryMaximumProcessorCount.

Requisiti

Requisito Valore
Client minimo supportato Disponibile in Windows 7 e versioni successive di Windows.
Piattaforma di destinazione Universale
Intestazione wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Libreria NtosKrnl.lib
DLL NtosKrnl.exe
IRQL Qualsiasi livello

Vedi anche

KeQueryActiveProcessorCountEx

KeQueryMaximumProcessorCount