createMemoryResourceNotification 函数 (memoryapi.h)
创建内存资源通知对象。
语法
HANDLE CreateMemoryResourceNotification(
[in] MEMORY_RESOURCE_NOTIFICATION_TYPE NotificationType
);
parameters
[in] NotificationType
要向其发出对象的信号的内存条件。 此参数可以是 MEMORY_RESOURCE_NOTIFICATION_TYPE 枚举中的下列值之一。
值 | 含义 |
---|---|
|
可用物理内存不足。 |
|
可用物理内存较高。 |
返回值
如果函数成功,则返回值是内存资源通知对象的句柄。
如果函数失败,则返回值为 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 |