KeQueryHighestNodeNumber function (ntddk.h)
The KeQueryHighestNodeNumber routine returns the highest node number in a multiprocessor system that has a non-uniform memory access (NUMA) architecture.
Syntax
USHORT KeQueryHighestNodeNumber();
Return value
KeQueryHighestNodeNumber returns the highest node number.
Remarks
In a non-uniform memory access (NUMA) multiprocessor architecture, a node is a collection of processors that share fast access to a region of memory. Memory access is non-uniform because a processor can access the memory in its node faster than it can access the memory in other nodes.
If a NUMA multiprocessor system contains n nodes, the nodes are numbered from 0 to n-1, and KeQueryHighestNodeNumber returns n-1. If a system contains one node, KeQueryHighestNodeNumber returns zero.
If a system does not have a NUMA architecture, KeQueryHighestNodeNumber returns zero. An example of non-NUMA architecture is a symmetric multiprocessor system (SMP).
When Windows initializes a NUMA multiprocessor system, it assigns logical processors to nodes and counts the number of resulting nodes. Windows defines the capacity of a node as the number of processors that are present when the system starts in addition to any other logical processors that can be added to the node while the system is running. If, during initialization, Windows encounters a NUMA hardware node that contains more logical processors than will fit into a group, Windows splits the node into smaller, logical nodes. Each of these nodes does not exceed the maximum group size. The value that is returned by KeQueryHighestNodeNumber indicates the number of logical nodes in the system.
After the system has been initialized, the node count remains fixed while the system continues to run. This count might include memory-only nodes, which are nodes that contain memory but no active logical processors.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Available in Windows 7 and later versions of Windows. |
| Target Platform | Universal |
| Header | ntddk.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| Library | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | Any level |