Метод IHostMemoryManager::GetMemoryLoad
Получает объем используемой и недоступной в настоящий момент физической памяти в соответствии с отчетом узла.
HRESULT GetMemoryLoad (
[out] DWORD* pMemoryLoad,
[out] SIZE_T *pAvailableBytes
);
Параметры
pMemoryLoad
[out] Указатель приблизительного процентного значения общей физической памяти, используемой в настоящее время.pAvailableBytes
[out] Указатель количества байтов, доступных среде CLR.
Возвращаемое значение
HRESULT |
Описание |
|---|---|
S_OK |
Метод GetMemoryLoad успешно возвратил значение. |
HOST_E_CLRNOTAVAILABLE |
Среда CLR не загружена в процесс или находится в состоянии, в котором ей не удается выполнить управляемый код или успешно обработать вызов. |
HOST_E_TIMEOUT |
Время ожидания вызова истекло. |
HOST_E_NOT_OWNER |
Вызывающий объект не владеет блокировкой. |
HOST_E_ABANDONED |
Событие, которого ожидал заблокированный поток или нить, было отменено. |
E_FAIL |
Произошел неизвестный разрушительный сбой. Если метод вернет значение E_FAIL, среду CLR более нельзя будет использовать в данном процессе. Последующие вызовы методов размещения возвращают значение HOST_E_CLRNOTAVAILABLE. |
Заметки
GetMemoryLoad упаковывает функцию Win32 GlobalMemoryStatus. Значение pMemoryLoad является эквивалентным полю dwMemoryLoad в структуре MEMORYSTATUS, возвращенной GlobalMemoryStatus.
Среда выполнения использует возвращаемое значение в качестве эвристики для сборщика мусора. Например, если узел сообщает о том, что большая часть памяти используется, сборщик мусора может приступить к сборке мусора в нескольких поколениях с целью повышения объема потенциально доступной памяти.
Требования
Платформы: см. раздел Требования к системе для .NET Framework.
Заголовок: MSCorEE.h
Библиотека: включена как ресурс в MSCorEE.dll
Версии платформы .NET Framework: 4, 3.5 с пакетом обновления 1 (SP1), 3.5, 3.0 с пакетом обновления 1 (SP1), 3.0, 2.0 с пакетом обновления 1 (SP1), 2.0