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
標頭	memoryapi.h (包括 Windows.h、Memoryapi.h)
程式庫	onecore.lib
DLL	Kernel32.dll