ICLRMemoryNotificationCallback::OnMemoryNotification 方法
告知 Common Language Runtime (CLR) 電腦上的記憶體負載。
HRESULT OnMemoryNotification (
[in] EMemoryAvailable eMemoryAvailable
);
參數
- eMemoryAvailable
[in] 其中一個 EMemoryAvailable 值，表示電腦目前正面臨的記憶體壓力。
傳回值
HRESULT |
描述 |
|---|---|
S_OK |
OnMemoryNotification 已成功傳回。 |
HOST_E_CLRNOTAVAILABLE |
CLR 尚未載入至處理序中，或者此 CLR 目前的狀態無法執行 Managed 程式碼或成功處理呼叫。 |
HOST_E_TIMEOUT |
呼叫已逾時。 |
HOST_E_NOT_OWNER |
呼叫端不具備鎖定功能。 |
HOST_E_ABANDONED |
已封鎖執行緒或 Fiber 在等候事件時，該事件已遭取消。 |
E_FAIL |
發生未知的重大錯誤。 在方法傳回 E_FAIL 之後，處理序中就無法再使用 CLR。 對裝載方法的後續呼叫會傳回 HOST_E_CLRNOTAVAILABLE。 |
備註
CLR 會呼叫 IHostMemoryManager::RegisterMemoryNotificationCallback 方法，將回呼註冊至 OnMemoryNotification。 當主應用程式報告記憶體資源不足時，執行階段會使用回呼中所傳回的資訊來釋放其他記憶體。
.gif "注意事項") 注意事項 |
|---|
OnMemoryNotification 的呼叫絕對不會封鎖。這些呼叫永遠都會立即傳回。 |
需求
**平台：**請參閱 .NET Framework 系統需求。
**標頭：**MSCorEE.h
程式庫：包含做為 MSCorEE.dll 中的資源
**.NET Framework 版本：**4、3.5 SP1、3.5、3.0 SP1、3.0、2.0 SP1、2.0