Функция CreateMemoryResourceNotification (memoryapi.h)

  • Статья

Создает объект уведомления ресурса памяти.

Синтаксис

HANDLE CreateMemoryResourceNotification(
  [in] MEMORY_RESOURCE_NOTIFICATION_TYPE NotificationType
);

Параметры

[in] NotificationType

Условие памяти, при котором объект должен быть сигнальным. Этот параметр может быть одним из следующих значений перечисления MEMORY_RESOURCE_NOTIFICATION_TYPE .

Значение Значение
LowMemoryResourceNotification
0
 Доступной физической памяти недостаточно.
HighMemoryResourceNotification
1
 Объем доступной физической памяти.

Возвращаемое значение

Если функция выполняется успешно, возвращаемое значение является дескриптором для объекта уведомления ресурса памяти.

Если функция завершается сбоем, возвращается значение NULL. Чтобы получить дополнительные сведения, вызовите Метод GetLastError.

Комментарии

Приложения могут использовать события уведомлений о ресурсах памяти для соответствующего масштабирования использования памяти. Если доступной памяти недостаточно, приложение может уменьшить свой рабочий набор. Если доступной памяти достаточно, приложение может выделить больше памяти.

Любой поток вызывающего процесса может указать дескриптор уведомления о ресурсе памяти при вызове функции QueryMemoryResourceNotification или одной из функций wait. Состояние объекта сигнализируется при наличии указанного условия памяти. Это событие всей системы, поэтому все приложения получают уведомления о сигнале об объекте. Обратите внимание, что существует диапазон доступности памяти, в котором не указан ни объект LowMemoryResourceNotification , ни HighMemoryResourceNotification . В этом случае приложения должны пытаться сохранить использование памяти постоянно.

Используйте функцию CloseHandle , чтобы закрыть дескриптор. Система автоматически закрывает дескриптор при завершении процесса. Объект уведомления ресурса памяти уничтожается при закрытии последнего дескриптора.

Чтобы скомпилировать приложение, использующее эту функцию, определите макрос _WIN32_WINNT как 0x0501 или более поздней версии. Дополнительные сведения см. в разделе Использование заголовков Windows.

Требования

   
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header memoryapi.h (включая Windows.h, Memoryapi.h)
Библиотека onecore.lib
DLL Kernel32.dll

См. также

CloseHandle

Функции управления памятью

QueryMemoryResourceNotification