QueryMemoryResourceNotification function (memoryapi.h)

Retrieves the state of the specified memory resource object.

Syntax

BOOL QueryMemoryResourceNotification(
  [in]  HANDLE ResourceNotificationHandle,
  [out] PBOOL  ResourceState
);

Parameters

[in] ResourceNotificationHandle

A handle to a memory resource notification object. The CreateMemoryResourceNotification function returns this handle.

[out] ResourceState

The memory pointed to by this parameter receives the state of the memory resource notification object. The value of this parameter is set to TRUE if the specified memory condition exists, and FALSE if the specified memory condition does not exist.

Return value

If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero. For more error information, call GetLastError.

Remarks

Unlike the wait functions, QueryMemoryResourceNotification does not block the calling thread. Therefore, it is an efficient way to check the state of physical memory before proceeding with an operation.

To compile an application that uses this function, define the _WIN32_WINNT macro as 0x0501 or later. For more information, see Using the Windows Headers.

Requirements

Requirement Value
Minimum supported client Windows XP [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header memoryapi.h (include Windows.h, Memoryapi.h)
Library onecore.lib
DLL Kernel32.dll

See also

CreateMemoryResourceNotification

Memory Management Functions