Retrieves the processor mask for the specified node.

Use the GetNumaNodeProcessorMaskEx function to retrieve the processor mask for a node in any processor group.

Syntax

BOOL WINAPI GetNumaNodeProcessorMask(
  __in   UCHAR Node,
  __out  PULONGLONG ProcessorMask
);

Parameters

Node [in]

The number of the node.

ProcessorMask [out]

The processor mask for the node. A processor mask is a bit vector in which each bit represents a processor and whether it is in the node.

On systems with more than 64 processors, this parameter is set to the processor mask for the node only if the node is in the same processor group as the calling thread. Otherwise, the parameter is set to zero.

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 highest numbered node in the system, use the GetNumaHighestNodeNumber function. Note that this number is not guaranteed to equal the total number of nodes in the system.

To ensure that all threads for your process run on the same node, use the SetProcessAffinityMask function with a process affinity mask that specifies processors in the same node.

Requirements

See Also

GetNumaNodeProcessorMaskEx

GetNumaProcessorNode

NUMA Support

Process and Thread Functions

SetProcessAffinityMask

Send comments about this topic to Microsoft

Build date: 11/19/2009