IHostMemoryManager::RegisterMemoryNotificationCallback 方法
登錄主機叫用的回呼函式指標,以通知通用語言執行平台 (CLR) 有關電腦上的目前記憶體負載。
語法
HRESULT RegisterMemoryNotificationCallback (
[in] ICLRMemoryNotificationCallback* pCallback
);
參數
pCallback
[in] CLR 所實作之 ICLRMemoryNotificationCallback 執行個體的介面指標。
傳回值
HRESULT | 描述 |
---|---|
S_OK | RegisterMemoryNotificationCallback 已成功傳回。 |
HOST_E_CLRNOTAVAILABLE | CLR 尚未載入處理序,或 CLR 處於無法執行受控程式碼或成功處理呼叫的狀態。 |
HOST_E_TIMEOUT | 呼叫逾時。 |
HOST_E_NOT_OWNER | 呼叫端未擁有鎖定。 |
HOST_E_ABANDONED | 封鎖的執行緒或 Fiber 在其上等候時,事件遭到取消。 |
E_FAIL | 發生未知的重大失敗。 如果方法傳回 E_FAIL,則 CLR 就無法再用於處理序。 後續對裝載方法發出的呼叫會傳回 HOST_E_CLRNOTAVAILABLE。 |
備註
因為 ICLRMemoryNotificationCallback
介面只會定義一個方法 (ICLRMemoryNotificationCallback::OnMemoryNotification),而且因為 pCallback
是 CLR 所提供 ICLRMemoryNotificationCallback
執行個體的指標,所以註冊實際上是針對回呼函式本身。 主機會叫用 OnMemoryNotification
來報告記憶體壓力狀況,而不是使用標準 Win32 CreateMemoryResourceNotification
函式。 如需詳細資訊,請參閱 Windows 平台文件。
注意
永不封鎖 OnMemoryNotification
的呼叫。 它們一律會立即返回。
規格需求
平台:請參閱系統需求。
標題: MSCorEE.h
程式庫:包含作為 MSCorEE.dll 中的資源
.NET Framework版本:自 2.0 起可用