Retrieves the node number for the specified proximity identifier.

Use the GetNumaProximityNodeEx function to retrieve the node number as a USHORT value.

Syntax

BOOL WINAPI GetNumaProximityNode(
  __in   ULONG ProximityId,
  __out  PUCHAR NodeNumber
);

Parameters

ProximityId [in]

The proximity identifier of the node.

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

Proximity identifiers are stored in system firmware and are typically used only by management applications provided by system manufacturers.

Requirements

See Also

GetNumaProcessorNode

GetNumaProximityNodeEx

NUMA Support

Send comments about this topic to Microsoft

Build date: 11/19/2009