IHostMemoryManager::GetMemoryLoad — Metoda
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
