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 起可用

另请参阅