Funzione KeQueryActiveGroupCount (ntddk.h)
La routine KeQueryActiveGroupCount restituisce il numero di gruppi di processori attivi in un sistema multiprocessore.
Sintassi
USHORT KeQueryActiveGroupCount();
Valore restituito
KeQueryActiveGroupCount restituisce un conteggio dei gruppi attivi.
Osservazioni
Un gruppo di processori è attivo se contiene uno o più processori logici attivi.
Un processore logico attivo è un processore logico che Windows ha avviato e aggiunto a un sistema multiprocessore. Il termine processore attivo si applica a un processore disponibile per eseguire il lavoro di elaborazione, indipendentemente dal fatto che il processore stia eseguendo il lavoro di elaborazione o sia inattiva. In alcuni sistemi, il numero di processori attivi potrebbe rimanere invariato dall'avvio del sistema all'arresto. In altri sistemi, Windows potrebbe aggiungere dinamicamente processori attivi mentre il sistema è in esecuzione. Windows non rimuove mai i processori attivi da un sistema.
Di conseguenza, il numero di processori attivi in un sistema multiprocessore può aumentare tra l'avvio del sistema e l'arresto, ma questo numero non diminuisce mai. Analogamente, il numero di gruppi attivi nel sistema può aumentare se un processore viene aggiunto dinamicamente a un gruppo inattivo mentre il sistema è in esecuzione. Il numero di gruppi attivi non diminuisce mai.
Al contrario, il valore restituito da KeQueryMaximumGroupCount rimane costante durante il runtime. Questo valore è il numero massimo di gruppi che il sistema può avere.
Chiamare la routine keQueryActiveProcessorCountEx per determinare il numero di processori logici attivi in un determinato gruppo.
Windows 7 è la prima versione di Windows a supportare i gruppi di processori. In Windows 7, solo le versioni a 64 bit di Windows supportano più gruppi; Le versioni a 32 bit di Windows supportano un solo gruppo. Un sistema multiprocessore che esegue una versione a 32 bit di Windows non può contenere più di 32 processori.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Disponibile a partire da Windows 7. |
| piattaforma di destinazione | Universale |
| intestazione | ntddk.h (include Ntddk.h, Wdm.h, Ntddk.h) |
| libreria | NtosKrnl.lib |
| dll | NtosKrnl.exe |
| IRQL | Qualsiasi livello |