Função KeQueryActiveGroupCount (ntddk.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 de 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 da inicialização do sistema para 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.

Assim, 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, somente 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. 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	ntddk.h (inclua Ntddk.h, Wdm.h, Ntddk.h)
Biblioteca	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	Qualquer nível

Confira também

KeQueryActiveProcessorCountEx

KeQueryMaximumGroupCount