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

Confira também

KeQueryActiveProcessorCountEx

KeQueryMaximumGroupCount