IHostMemoryManager::RegisterMemoryNotificationCallback 方法
注册一个指向某回调函数的指针,宿主通过调用该回调函数将计算机上当前的内存加载情况通知给公共语言运行时 (CLR)。
HRESULT RegisterMemoryNotificationCallback (
[in] ICLRMemoryNotificationCallback* pCallback
);
参数
- pCallback
[in] 一个接口指针,该指针指向由 CLR 所实现的 ICLRMemoryNotificationCallback 实例。
返回值
HRESULT |
说明 |
---|---|
S_OK |
RegisterMemoryNotificationCallback 已成功返回。 |
HOST_E_CLRNOTAVAILABLE |
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 的调用从不会阻止。它们总是立即返回。 |
要求
**平台:**请参见 .NET Framework 系统要求。
**头文件:**MSCorEE.h
**库:**作为一项资源包含在 MSCorEE.dll 中
**.NET Framework 版本:**4、3.5 SP1、3.5、3.0 SP1、3.0、2.0 SP1、2.0