Función KeQueryHighestNodeNumber (ntddk.h)

La rutina KeQueryHighestNodeNumber devuelve el número de nodo más alto de un sistema multiprocesador que tiene una arquitectura de acceso a memoria no uniforme (NUMA).

Sintaxis

USHORT KeQueryHighestNodeNumber();

Valor devuelto

KeQueryHighestNodeNumber devuelve el número de nodo más alto.

Comentarios

En una arquitectura de varios procesadores de acceso a memoria no uniforme (NUMA), un nodo es una colección de procesadores que comparten acceso rápido a una región de memoria. El acceso a la memoria no es uniforme porque un procesador puede acceder a la memoria en su nodo más rápido de lo que puede acceder a la memoria en otros nodos.

Si un sistema multiprocesador NUMA contiene n nodos, los nodos se numeran de 0 a n-1 y KeQueryHighestNodeNumber devuelve n-1. Si un sistema contiene un nodo, KeQueryHighestNodeNumber devuelve cero.

Si un sistema no tiene una arquitectura NUMA, KeQueryHighestNodeNumber devuelve cero. Un ejemplo de arquitectura que no es NUMA es un sistema de multiprocesador simétrico (SMP).

Cuando Windows inicializa un sistema multiprocesador NUMA, asigna procesadores lógicos a nodos y cuenta el número de nodos resultantes. Windows define la capacidad de un nodo como el número de procesadores presentes cuando el sistema se inicia además de cualquier otro procesador lógico que se pueda agregar al nodo mientras se ejecuta el sistema. Si, durante la inicialización, Windows encuentra un nodo de hardware NUMA que contiene más procesadores lógicos de los que caben en un grupo, Windows divide el nodo en nodos lógicos más pequeños. Cada uno de estos nodos no supera el tamaño máximo del grupo. El valor devuelto por KeQueryHighestNodeNumber indica el número de nodos lógicos del sistema.

Una vez inicializado el sistema, el número de nodos permanece fijo mientras el sistema continúa ejecutándose. Este recuento puede incluir nodos de solo memoria, que son nodos que contienen memoria, pero no procesadores lógicos activos.

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible en Windows 7 y versiones posteriores de Windows.
Plataforma de destino	Universal
Encabezado	ntddk.h (incluya Wdm.h, Ntddk.h, Ntifs.h)
Library	NtosKrnl.lib
Archivo DLL	NtosKrnl.exe
IRQL	Cualquier nivel