ICLRMemoryNotificationCallback::OnMemoryNotification 方法
向公共语言运行时 (CLR) 通知计算机的内存负载情况。
语法
HRESULT OnMemoryNotification (
[in] EMemoryAvailable eMemoryAvailable
);
参数
eMemoryAvailable
[in] EMemoryAvailable 值之一,指示计算机当前遇到的内存压力。
返回值
HRESULT | 说明 |
---|---|
S_OK | 已成功返回 OnMemoryNotification 。 |
HOST_E_CLRNOTAVAILABLE | CLR 未加载到进程中,或 CLR 处于无法运行托管代码或无法成功处理调用的状态。 |
HOST_E_TIMEOUT | 调用超时。 |
HOST_E_NOT_OWNER | 调用方未持有锁。 |
HOST_E_ABANDONED | 阻塞的线程或纤程正在等待某一事件,而该事件已被取消。 |
E_FAIL | 发生未知的灾难性故障。 某方法返回 E_FAIL 后,进程中无法再使用 CLR。 后续调用承载方法会返回 HOST_E_CLRNOTAVAILABLE。 |
注解
CLR 使用对 IHostMemoryManager::RegisterMemoryNotificationCallback 方法的调用向 OnMemoryNotification
注册回调。 当主机报告内存资源不足时,运行时将使用回调中返回的信息释放额外内存。
备注
对 OnMemoryNotification
的调用从不阻塞。 这些调用始终立即返回。
要求
平台:请参阅系统要求。
标头:MSCorEE.h
库:作为资源包含在 MSCorEE.dll 中
.NET Framework 版本:自 2.0 起可用