createMemoryResourceNotification 函数 (memoryapi.h)

  • 项目

创建内存资源通知对象。

语法

HANDLE CreateMemoryResourceNotification(
  [in] MEMORY_RESOURCE_NOTIFICATION_TYPE NotificationType
);

parameters

[in] NotificationType

要向其发出对象的信号的内存条件。 此参数可以是 MEMORY_RESOURCE_NOTIFICATION_TYPE 枚举中的下列值之一。

值 含义
LowMemoryResourceNotification
0
 可用物理内存不足。
HighMemoryResourceNotification
1
 可用物理内存较高。

返回值

如果函数成功，则返回值是内存资源通知对象的句柄。

如果函数失败，则返回值为 NULL。 若要获取扩展信息，请调用 GetLastError。

注解

应用程序可以使用内存资源通知事件来根据需要缩放内存使用量。 如果可用内存不足，应用程序可能会减少其工作集。 如果可用内存较高，应用程序可以分配更多内存。

调用进程的任何线程都可以在对 QueryMemoryResourceNotification 函数或 等待函数之一的调用中指定内存资源通知句柄。 当指定的内存条件存在时，将发出对象的状态信号。 这是系统范围的事件，因此所有应用程序在发出对象信号时都会收到通知。 请注意，存在一系列内存可用性，其中 LowMemoryResourceNotification 或 HighMemoryResourceNotification 对象都没有信号。 在这种情况下，应用程序应尝试保持内存使用常量。

使用 CloseHandle 函数关闭句柄。 进程终止时，系统会自动关闭句柄。 内存资源通知对象在关闭其最后一个句柄时被销毁。

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

要求

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

另请参阅

CloseHandle

内存管理函数

QueryMemoryResourceNotification