Udostępnij za pośrednictwem

IHostMemoryManager::GetMemoryLoad — Metoda

  • Artykuł

Pobiera ilość pamięci fizycznej, która jest obecnie używana, a zatem niedostępna zgodnie z raportem hosta.

Składnia

HRESULT GetMemoryLoad (  
    [out] DWORD*  pMemoryLoad,
    [out] SIZE_T  *pAvailableBytes  
);

Parametry

pMemoryLoad
[out] Wskaźnik do przybliżonej wartości procentowej całkowitej pamięci fizycznej, która jest obecnie używana.

pAvailableBytes
[out] Wskaźnik do liczby bajtów dostępnych dla środowiska uruchomieniowego języka wspólnego (CLR).

Wartość zwracana

HRESULT Opis
S_OK GetMemoryLoad zwrócono pomyślnie.
HOST_E_CLRNOTAVAILABLE ClR nie został załadowany do procesu lub CLR jest w stanie, w którym nie może uruchomić kodu zarządzanego ani pomyślnie przetworzyć wywołania.
HOST_E_TIMEOUT Upłynął limit czasu wywołania.
HOST_E_NOT_OWNER Obiekt wywołujący nie jest właścicielem blokady.
HOST_E_ABANDONED Zdarzenie zostało anulowane, gdy zablokowany wątek lub światłowod czekał na nie.
E_FAIL Wystąpił nieznany katastrofalny błąd. Gdy metoda zwraca E_FAIL, clR nie będzie już można używać w ramach tego procesu. Kolejne wywołania metod hostingu zwracają HOST_E_CLRNOTAVAILABLE.

Uwagi

GetMemoryLoad opakowuje funkcję Win32 GlobalMemoryStatus . Wartość jest pMemoryLoad odpowiednikiem dwMemoryLoad pola w strukturze zwróconej MEMORYSTATUS z GlobalMemoryStatus.

Środowisko uruchomieniowe używa wartości zwracanej jako heurystyki dla modułu odśmiecniania pamięci. Jeśli na przykład host zgłasza, że większość pamięci jest używana, moduł odśmiecenia pamięci może zdecydować się na zbieranie z wielu pokoleń w celu zwiększenia ilości pamięci, która może potencjalnie stać się dostępna.

Wymagania

Platformy: Zobacz Wymagania systemowe.

Nagłówka: MSCorEE.h

Biblioteki: Uwzględnione jako zasób w MSCorEE.dll

.NET Framework wersje: dostępne od wersji 2.0

Zobacz też