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 |