IHostMemoryManager::GetMemoryLoad – metoda
Získá velikost fyzické paměti, která se právě používá, a proto není k dispozici, jak je hlášeno hostitelem.
Syntaxe
HRESULT GetMemoryLoad (
[out] DWORD* pMemoryLoad,
[out] SIZE_T *pAvailableBytes
);
Parametry
pMemoryLoad
[out] Ukazatel na přibližné procento celkové fyzické paměti, která se právě používá.
pAvailableBytes
[out] Ukazatel na počet bajtů dostupných pro modul CLR (Common Language Runtime).
Návratová hodnota
| HRESULT | Description |
|---|---|
| S_OK | GetMemoryLoad úspěšně vráceno. |
| HOST_E_CLRNOTAVAILABLE | ClR nebyl načten do procesu nebo clr je ve stavu, ve kterém nemůže spustit spravovaný kód nebo úspěšně zpracovat volání. |
| HOST_E_TIMEOUT | Časový limit hovoru vypršel. |
| HOST_E_NOT_OWNER | Volající zámek nevlastní. |
| HOST_E_ABANDONED | Událost byla zrušena, když na ni čekalo blokované vlákno nebo vlákno. |
| E_FAIL | Došlo k neznámému katastrofickému selhání. Když metoda vrátí E_FAIL, CLR už není v rámci procesu použitelný. Následná volání metod hostování vrátí HOST_E_CLRNOTAVAILABLE. |
Poznámky
GetMemoryLoad zabalí funkci Win32 GlobalMemoryStatus . Hodnota je pMemoryLoad ekvivalentem dwMemoryLoad pole ve struktuře MEMORYSTATUS vrácené z GlobalMemoryStatus.
Modul runtime používá návratovou hodnotu jako heuristiku pro systém uvolňování paměti. Pokud například hostitel hlásí, že se používá většina paměti, může se systém uvolňování paměti rozhodnout shromáždit z více generací, aby zvýšil množství paměti, které může být potenciálně dostupné.
Požadavky
Platformy: Viz Požadavky na systém.
Záhlaví: MSCorEE.h
Knihovny: Zahrnuto jako prostředek v MSCorEE.dll
Verze rozhraní .NET Framework: K dispozici od verze 2.0
