GetNumaProcessorNode function (winbase.h)

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(
  [in]  UCHAR  Processor,
  [out] PUCHAR NodeNumber
);

Parameters

[in] 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.

[out] 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

See also

GetNumaNodeProcessorMask

GetNumaProcessorNodeEx

GetNumaProximityNode

GetProcessAffinityMask

NUMA Support