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 di, 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.
Osservazioni
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 dal KeQueryActiveProcessorCountEx routine 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, 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 ai gruppi vengano eseguite correttamente nei sistemi multiprocessore con due o più gruppi. Tuttavia, i driver che usano qualsiasi funzionalità orientata ai gruppi in Windows 7 e versioni successive del sistema operativo Windows devono chiamare KeQueryMaximumProcessorCountEx anziché KeQueryMaximumProcessorCount.
Fabbisogno
| 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 |