GetNumaProcessorNode function

Retrieves the node number for the specified processor.

Use the GetNumaProcessorNodeEx function to specify a processor group and retrieve the node number as a USHORT value.

Syntax

BOOL GetNumaProcessorNode(
  UCHAR  Processor,
  PUCHAR NodeNumber
);

Parameters

Processor

The processor number.

On a system with more than 64 logical processors, the processor number is relative to the processor group that contains the processor on which the calling thread is running.

NodeNumber

The node number. If the processor does not exist, this parameter is 0xFF.

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.

Remarks

To retrieve the list of processors on the system, use the GetProcessAffinityMask function.

Examples

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

Requirements

   
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 winbase.h (include Windows.h)
Library Kernel32.lib
DLL Kernel32.dll

See Also

GetNumaNodeProcessorMask

GetNumaProcessorNodeEx

GetNumaProximityNode

GetProcessAffinityMask

NUMA Support