GetNumaHighestNodeNumber function (systemtopologyapi.h)

Retrieves the node that currently has the highest number.


BOOL GetNumaHighestNodeNumber(
  [out] PULONG HighestNodeNumber


[out] HighestNodeNumber

The number of the highest node.

Return value

If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero. To get extended error information, call GetLastError.


The number of the highest node is not guaranteed to be the total number of nodes.

To retrieve a list of all processors in a node, use the GetNumaNodeProcessorMask function.


For an example, see Allocating Memory from a NUMA Node.


Requirement Value
Minimum supported client Windows Vista, Windows XP Professional x64 Edition, Windows XP with SP2 [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header systemtopologyapi.h (include Windows.h on Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2)
Library Kernel32.lib
DLL Kernel32.dll

See also


NUMA Support

Process and Thread Functions