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 WINAPI GetNumaProcessorNode(
  __in   UCHAR Processor,
  __out  PUCHAR NodeNumber
);

Parameters

Processor [in]

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

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

Send comments about this topic to Microsoft

Build date: 11/19/2009