Expand Minimize

GetNumaAvailableMemoryNodeEx function

Retrieves the amount of memory that is available in a node specified as a USHORT value.

Syntax


BOOL GetNumaAvailableMemoryNodeEx(
  _In_   USHORT 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 GetNumaAvailableMemoryNodeEx 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.

The only difference between the GetNumaAvailableMemoryNodeEx function and the GetNumaAvailableMemoryNode function is the data type of the Node parameter.

To compile an application that uses this function, set _WIN32_WINNT >= 0x0601. For more information, see Using the Windows Headers.

Requirements

Minimum supported client

Windows 7 [desktop apps only]

Minimum supported server

Windows Server 2008 R2 [desktop apps only]

Header

WinBase.h (include Windows.h)

Library

Kernel32.lib

DLL

Kernel32.dll

See also

GetNumaAvailableMemoryNode
NUMA Support

 

 

Community Additions

ADD
Show:
© 2014 Microsoft