Expand Minimize

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 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

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]

Header

WinBase.h (include Windows.h)

Library

Kernel32.lib

DLL

Kernel32.dll

See also

GetNumaNodeProcessorMask
GetNumaProcessorNodeEx
GetNumaProximityNode
GetProcessAffinityMask
NUMA Support

 

 

Community Additions

ADD
Show:
© 2014 Microsoft