Partilhar via

Função KeQueryHighestNodeNumber (ntddk.h)

  • Artigo

A rotina KeQueryHighestNodeNumber retorna o número de nó mais alto em um sistema multiprocessador que tem uma arquitetura NUMA (acesso à memória) não uniforme.

Sintaxe

USHORT KeQueryHighestNodeNumber();

Valor de retorno

KeQueryHighestNodeNumber retorna o número de nó mais alto.

Observações

Em uma arquitetura de multiprocessador NUMA (acesso à memória) não uniforme, um nó é uma coleção de processadores que compartilham acesso rápido a uma região de memória. O acesso à memória não é uniforme porque um processador pode acessar a memória em seu nó mais rapidamente do que pode acessar a memória em outros nós.

Se um sistema multiprocessador NUMA contiver n nós, os nós serão numerados de 0 a n-1 e KeQueryHighestNodeNumber retornará n-1. Se um sistema contiver um nó, KeQueryHighestNodeNumber retornará zero.

Se um sistema não tiver uma arquitetura NUMA, KeQueryHighestNodeNumber retornará zero. Um exemplo de arquitetura não NUMA é um SMP (sistema multiprocessador simétrico).

Quando o Windows inicializa um sistema multiprocessador NUMA, ele atribui processadores lógicos a nós e conta o número de nós resultantes. O Windows define a capacidade de um nó como o número de processadores presentes quando o sistema é iniciado, além de outros processadores lógicos que podem ser adicionados ao nó enquanto o sistema está em execução. Se, durante a inicialização, o Windows encontrar um nó de hardware NUMA que contenha mais processadores lógicos do que caberá em um grupo, o Windows dividirá o nó em nós lógicos menores. Cada um desses nós não excede o tamanho máximo do grupo. O valor retornado pelo KeQueryHighestNodeNumber indica o número de nós lógicos no sistema.

Depois que o sistema for inicializado, a contagem de nós permanecerá fixa enquanto o sistema continua a ser executado. Essa contagem pode incluir nós somente memória, que são nós que contêm memória, mas sem processadores lógicos ativos.

Requisitos

Requisito Valor
de cliente com suporte mínimo Disponível no Windows 7 e versões posteriores do Windows.
da Plataforma de Destino Universal
cabeçalho ntddk.h (incluem Wdm.h, Ntddk.h, Ntifs.h)
biblioteca NtosKrnl.lib
de DLL NtosKrnl.exe
IRQL Qualquer nível