QueryMemoryResourceNotification 函数 (memoryapi.h)

检索指定内存资源对象的状态。

语法

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

parameters

[in] ResourceNotificationHandle

内存资源通知对象的句柄。 CreateMemoryResourceNotification 函数返回此句柄。

[out] ResourceState

此参数指向的内存接收内存资源通知对象的状态。 如果指定的内存条件存在,则此参数的值设置为 TRUE ;如果指定的内存条件不存在,则设置为 FALSE

返回值

如果该函数成功,则返回值为非零值。

如果函数失败,则返回值为零。 有关更多错误信息,请调用 GetLastError

注解

wait 函数不同, QueryMemoryResourceNotification 不会阻止调用线程。 因此,这是在继续操作之前检查物理内存状态的有效方法。

若要编译使用此函数的应用程序,请将 _WIN32_WINNT 宏定义为 0x0501 或更高版本。 有关详细信息,请参阅 使用 Windows 标头

要求

   
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 memoryapi.h (包括 Windows.h、Memoryapi.h)
Library onecore.lib
DLL Kernel32.dll

另请参阅

CreateMemoryResourceNotification

内存管理函数