IHostMemoryManager::RegisterMemoryNotificationCallback 方法

發行項
08/12/2011

註冊主應用程式叫用的回呼函式指標，以便告知 Common Language Runtime (CLR) 電腦上目前的記憶體負載。

HRESULT RegisterMemoryNotificationCallback (
    [in] ICLRMemoryNotificationCallback* pCallback
);

參數

pCallback
[in] CLR 實作之 ICLRMemoryNotificationCallback 執行個體的介面指標。

傳回值

HRESULT	描述
S_OK	RegisterMemoryNotificationCallback 已成功傳回。
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。

備註

由於 ICLRMemoryNotificationCallback 介面僅定義一個方法 (ICLRMemoryNotificationCallback::OnMemoryNotification)，而且 pCallback 是 CLR 提供之 ICLRMemoryNotificationCallback 執行個體的指標，因此註冊可有效用於回呼本身。主應用程式會叫用 OnMemoryNotification 來報告記憶體壓力的情況，而不會使用標準的 Win32 CreateMemoryResourceNotification 函式。如需詳細資訊，請參閱 Windows 平台的說明文件。