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

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

Синтаксис

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

Параметры

[in] ResourceNotificationHandle

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

[out] ResourceState

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

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

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

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

Комментарии

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

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

Требования

См. также

CreateMemoryResourceNotification

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