GetNumaAvailableMemoryNode function (winbase.h)

Retrieves the amount of memory available in the specified node.

Use the GetNumaAvailableMemoryNodeEx function to specify the node as a USHORT value.

Syntax

BOOL GetNumaAvailableMemoryNode(
  [in]  UCHAR      Node,
  [out] PULONGLONG AvailableBytes
);

Parameters

[in] Node

The number of the node.

[out] AvailableBytes

The amount of available memory for the node, in bytes.

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

The GetNumaAvailableMemoryNode function returns the amount of memory consumed by free and zeroed pages on the specified node. On systems with more than one node, this memory does not include standby pages. Therefore, the sum of the available memory values for all nodes in the system is equal to the value of the Free & Zero Page List Bytes memory performance counter. On systems with only one node, the value returned by GetNumaAvailableMemoryNode includes standby pages and is equal to the value of the Available Bytes memory performance counter. For more information about performance counters, see Memory Performance Information.

Requirements

Requirement Value
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]
Target Platform Windows
Header winbase.h (include Windows.h)
Library Kernel32.lib
DLL Kernel32.dll

See also

GetNumaAvailableMemoryNodeEx

NUMA Support

Process and Thread Functions