Função KeQueryActiveGroupCount (wdm.h)
A rotina KeQueryActiveGroupCount retorna o número de grupos de processadores ativos em um sistema multiprocessador.
Sintaxe
USHORT KeQueryActiveGroupCount();
Retornar valor
KeQueryActiveGroupCount retorna uma contagem dos grupos ativos.
Comentários
Um grupo de processadores estará ativo se contiver um ou mais processadores lógicos ativos.
Um processador lógico ativo é um processador lógico que o Windows iniciou e adicionou a um sistema multiprocessador. O termo processador ativo aplica-se a um processador que está disponível para executar o trabalho de processamento, independentemente se o processador está executando o trabalho de processamento ou está ocioso no momento. Em alguns sistemas, o número de processadores ativos pode permanecer inalterado desde a inicialização do sistema até o desligamento. Em outros sistemas, o Windows pode adicionar dinamicamente processadores ativos enquanto o sistema está em execução. O Windows nunca remove processadores ativos de um sistema.
Portanto, o número de processadores ativos em um sistema multiprocessador pode aumentar entre a inicialização e o desligamento do sistema, mas esse número nunca diminui. Da mesma forma, o número de grupos ativos no sistema poderá aumentar se um processador for adicionado dinamicamente a um grupo inativo enquanto o sistema estiver em execução. O número de grupos ativos nunca diminui.
Por outro lado, o valor retornado por KeQueryMaximumGroupCount permanece constante durante o runtime. Esse valor é o número máximo de grupos que o sistema pode ter.
Chame a rotina KeQueryActiveProcessorCountEx para determinar o número de processadores lógicos ativos em um grupo específico.
O Windows 7 é a primeira versão do Windows a dar suporte a grupos de processadores. No Windows 7, apenas versões de 64 bits do Windows dão suporte a vários grupos; As versões de 32 bits do Windows dão suporte a apenas um grupo. Se um sistema multiprocessador estiver executando uma versão de 64 bits do Windows e contiver no máximo 64 processadores lógicos, o Windows atribuirá todos os processadores ao grupo 0. Um sistema multiprocessador que está executando uma versão de 32 bits do Windows não pode conter mais de 32 processadores.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Disponível a partir do Windows 7. |
| Plataforma de Destino | Universal |
| Cabeçalho | wdm.h (inclua Ntddk.h, Wdm.h, Ntddk.h) |
| Biblioteca | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | Qualquer nível |