Метод ICLRMemoryNotificationCallback::OnMemoryNotification

Статья
11/16/2008

Обновлен: Ноябрь 2007

Уведомляет среду CLR о загруженности памяти компьютера.

HRESULT OnMemoryNotification (
    [in] EMemoryAvailable eMemoryAvailable
);

Параметры

eMemoryAvailable
[in] Одно из значений EMemoryAvailable, указывающее на то, что на компьютере наблюдается нехватка памяти.

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

HRESULT	Описание
S_OK	Метод OnMemoryNotification успешно возвратил значение.
HOST_E_CLRNOTAVAILABLE	Среда CLR не загружена в процесс или находится в состоянии, в котором ей не удается выполнить управляемый код или успешно обработать вызов.
HOST_E_TIMEOUT	Время ожидания вызова истекло.
HOST_E_NOT_OWNER	Вызывающий объект не владеет блокировкой.
HOST_E_ABANDONED	Событие, которого ожидал заблокированный поток или нить, было отменено.
E_FAIL	Произошел неизвестный разрушительный сбой. После того как метод вернет значение E_FAIL, среду CLR более нельзя будет использовать в данном процессе. Последующие вызовы методов размещения возвращают значение HOST_E_CLRNOTAVAILABLE.

Заметки

Среда CLR регистрирует обратный вызов OnMemoryNotification, используя вызов метода IHostMemoryManager::RegisterMemoryNotificationCallback. Среда выполнения использует сведения, возвращенные при обратном вызове, для высвобождения дополнительной памяти, когда основное приложение сообщает о том, что ресурсов памяти недостаточно.

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