Поделиться через


Метод IHostMemoryManager::RegisterMemoryNotificationCallback

Регистрирует указатель на функцию обратного вызова, вызываемую узлом для уведомления среды CLR о текущей нагрузке памяти на компьютере.

Синтаксис

HRESULT RegisterMemoryNotificationCallback (  
    [in] ICLRMemoryNotificationCallback* pCallback  
);  

Параметры

pCallback
[in] Указатель интерфейса на экземпляр ICLRMemoryNotificationCallback , реализованный средой CLR.

Возвращаемое значение

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 является указателем на экземпляр, предоставленный ICLRMemoryNotificationCallback средой CLR, регистрация фактически выполняется для самой функции обратного вызова. Узел вызывает OnMemoryNotification , чтобы сообщить об условиях нехватки памяти, а не использовать стандартную функцию Win32 CreateMemoryResourceNotification . Дополнительные сведения см. в документации по платформе Windows.

Примечание

Вызовы никогда OnMemoryNotification не блокируются. Они всегда возвращаются немедленно.

Требования

Платформы: см. раздел Требования к системе.

Заголовка: MSCorEE.h

Библиотека: Включено в качестве ресурса в MSCorEE.dll

версии платформа .NET Framework: доступно с версии 2.0

См. также раздел