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

Viz také

• System.GC
• IHostMemoryManager – rozhraní