CreateMemoryResourceNotification 函式 (memoryapi.h)
建立記憶體資源通知物件。
語法
HANDLE CreateMemoryResourceNotification(
[in] MEMORY_RESOURCE_NOTIFICATION_TYPE NotificationType
);
參數
[in] NotificationType
要發出訊號物件的記憶體條件。 此參數可以是下列 MEMORY_RESOURCE_NOTIFICATION_TYPE列舉值 之一。
| 值 | 意義 |
|---|---|
|
可用的實體記憶體執行不足。 |
|
可用的實體記憶體很高。 |
傳回值
如果函式成功，則傳回值是記憶體資源通知物件的控制碼。
如果函式失敗，傳回值為 Null。 若要取得擴充資訊，請呼叫 GetLastError。
備註
應用程式可以使用記憶體資源通知事件，適當地調整記憶體使用量。 如果可用的記憶體不足，應用程式可以減少其工作集。 如果可用的記憶體很高，應用程式可以配置更多記憶體。
呼叫進程的任何執行緒都可以在 QueryMemoryResourceNotification 函式或其中一個 等候函式的呼叫中指定記憶體資源通知控制碼。 當指定的記憶體條件存在時，物件的狀態會發出訊號。 這是全系統的事件，因此所有應用程式都會在收到物件的訊號時收到通知。 請注意，記憶體可用性範圍不會發出 LowMemoryResourceNotification 或 HighMemoryResourceNotification 物件的訊號。 在此情況下，應用程式應該嘗試保留記憶體使用常數。
使用 CloseHandle 函式關閉控制碼。 當進程終止時，系統會自動關閉控制碼。 當最後一個控制碼關閉時，就會終結記憶體資源通知物件。
若要編譯使用此函式的應用程式，請將_WIN32_WINNT巨集定義為 0x0501 或更新版本。 如需詳細資訊，請參閱 使用 Windows 標頭。
需求
| 最低支援的用戶端 | Windows XP [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2003 [僅限桌面應用程式] |
| 目標平台 | Windows |
| 標頭 | memoryapi.h (包括 Windows.h、Memoryapi.h) |
| 程式庫 | onecore.lib |
| DLL | Kernel32.dll |