Funzione KeQueryMaximumProcessorCountEx (ntddk.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 è 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 perché i processori vengono aggiunti dinamicamente al sistema.

Una routine correlata, KeQueryMaximumProcessorCount, restituisce un numero massimo di processori, ma questa routine, a differenza di 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, 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 al gruppo verranno eseguite correttamente nei sistemi multiprocessore con due o più gruppi. Tuttavia, i driver che usano funzionalità orientate al gruppo 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	ntddk.h (include Wdm.h, Ntddk.h, Ntifs.h)
Libreria	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	Qualsiasi livello

Vedi anche

KeQueryActiveProcessorCountEx

KeQueryMaximumProcessorCount