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

  • Статья

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

Синтаксис

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

Параметры

[in] ResourceNotificationHandle

Дескриптор объекта уведомления ресурса памяти. Функция CreateMemoryResourceNotification возвращает этот дескриптор.

[out] ResourceState

Память, на которую указывает этот параметр, получает состояние объекта уведомления о ресурсе памяти. Этому параметру присваивается значение TRUE , если указанное условие памяти существует, и FALSE , если указанное условие памяти не существует.

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

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

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

Комментарии

В отличие от функций ожидания, QueryMemoryResourceNotification не блокирует вызывающий поток. Таким образом, это эффективный способ проверка состояние физической памяти перед продолжением операции.

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

Требования

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

См. также

CreateMemoryResourceNotification

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