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 阻塞的线程或纤程正在等待某一事件，而该事件已被取消。
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 起可用

请参阅