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