Função KeQueryHighestNodeNumber (ntddk.h)

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

Sintaxe

USHORT KeQueryHighestNodeNumber();

Retornar valor

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

Comentários

Em uma arquitetura de multiprocessador NUMA (acesso não uniforme à memória), 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 por KeQueryHighestNodeNumber indica o número de nós lógicos no sistema.

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

Requisitos

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