IHostMemoryManager::GetMemoryLoad 方法
获取主机报告的因当前正在使用而变得不可用的物理内存量。
语法
HRESULT GetMemoryLoad (
[out] DWORD* pMemoryLoad,
[out] SIZE_T *pAvailableBytes
);
参数
pMemoryLoad
[out] 指向当前正在使用的物理内存总量的近似百分比的指针。
pAvailableBytes
[out] 指向公共语言运行时 (CLR) 可用的字节数的指针。
返回值
HRESULT | 说明 |
---|---|
S_OK | 已成功返回 GetMemoryLoad 。 |
HOST_E_CLRNOTAVAILABLE | CLR 未加载到进程中,或 CLR 处于无法运行托管代码或无法成功处理调用的状态。 |
HOST_E_TIMEOUT | 调用超时。 |
HOST_E_NOT_OWNER | 调用方未持有锁。 |
HOST_E_ABANDONED | 阻塞的线程或纤程正在等待某一事件,而该事件已被取消。 |
E_FAIL | 发生未知的灾难性故障。 当方法返回 E_FAIL 时,进程中无法再使用 CLR。 后续调用承载方法会返回 HOST_E_CLRNOTAVAILABLE。 |
备注
GetMemoryLoad
包装 Win32 GlobalMemoryStatus
函数。 pMemoryLoad
的值与从 GlobalMemoryStatus
返回的 MEMORYSTATUS
结构中的 dwMemoryLoad
字段等效。
运行时使用返回值作为垃圾回收器的启发式方法。 例如,如果主机报告大部分内存在使用中,垃圾回收器可能会选择从多个代中收集,以增加潜在可用的内存量。
要求
平台:请参阅系统要求。
标头:MSCorEE.h
库:作为资源包含在 MSCorEE.dll 中
.NET Framework 版本:自 2.0 起可用