Função KeQueryMaximumProcessorCount (ntddk.h)

  • Artigo

A rotina KeQueryMaximumProcessorCount retorna o número máximo de processadores.

Sintaxe

ULONG KeQueryMaximumProcessorCount();

Retornar valor

KeQueryMaximumProcessorCount retorna o número máximo de processadores como um valor ULONG.

Comentários

O valor retornado pela rotina KeQueryMaximumProcessorCount não é alterado em runtime.

Se o código usar uma matriz de buffers, um buffer para cada processador, você deverá decidir se deve ter uma matriz de tamanho estatica com base em KeQueryMaximumProcessorCount ou em uma matriz de tamanho dinâmico com base em KeQueryActiveProcessorCount.

Para otimizar com base no número de processadores, você precisa de uma estrutura redimensionável para o Windows Server 2008. Nesse caso, use KeQueryActiveProcessorCount.

Se você não estiver otimizando e se as estruturas de dados resultantes do uso da contagem máxima de processadores forem relativamente pequenas, uma estrutura redimensionável não será necessária. Nesse caso, use KeQueryMaximumProcessorCount para determinar o tamanho de uma matriz estática.

O Windows 7 e versões posteriores do Windows dão suporte a grupos de processadores. Os drivers projetados para lidar com informações sobre grupos de processadores devem usar a rotina KeQueryMaximumProcessorCountEx , que especifica um grupo de processadores, em vez de KeQueryMaximumProcessorCount, o que não acontece. No entanto, a implementação de KeQueryMaximumProcessorCount no Windows 7 e versões posteriores do Windows fornece compatibilidade para drivers que foram gravados para versões anteriores do Windows, que não dão suporte a grupos de processadores. Nesta implementação, KeQueryMaximumProcessorCount retorna o número máximo de processadores lógicos que podem estar no grupo 0.

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível no Windows Vista e versões posteriores do Windows.
Plataforma de Destino Universal
Cabeçalho ntddk.h (inclua Wdm.h, Ntddk.h)
Biblioteca NtosKrnl.lib
DLL NtosKrnl.exe
IRQL Qualquer nível

Confira também

KeQueryActiveProcessorCount

KeQueryMaximumProcessorCountEx