Export (0) Print
Expand All
Expand Minimize

GetNumaAvailableMemoryNode function

Retrieves the amount of memory available in the specified node.

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

Syntax


BOOL WINAPI GetNumaAvailableMemoryNode(
  _In_   UCHAR Node,
  _Out_  PULONGLONG AvailableBytes
);

Parameters

Node [in]

The number of the node.

AvailableBytes [out]

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

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

GetNumaAvailableMemoryNodeEx
NUMA Support
Process and Thread Functions

 

 

Community Additions

ADD
Show:
© 2014 Microsoft