IHostMemoryManager::GetMemoryLoad metódus

Lekéri a jelenleg használatban lévő fizikai memória mennyiségét, ezért nem érhető el a gazdagép által jelentett módon.

Szintaxis

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

Paraméterek

pMemoryLoad
[kifelé] A jelenleg használatban lévő teljes fizikai memória hozzávetőleges százalékos arányára mutató mutató.

pAvailableBytes
[kifelé] Mutató a közös nyelvi futtatókörnyezet (CLR) számára elérhető bájtok számára.

Visszatérési érték

HRESULT	Description
S_OK	GetMemoryLoad sikeresen visszaadott.
HOST_E_CLRNOTAVAILABLE	A CLR nincs betöltve egy folyamatba, vagy a CLR olyan állapotban van, amelyben nem tudja futtatni a felügyelt kódot, vagy nem tudja sikeresen feldolgozni a hívást.
HOST_E_TIMEOUT	A hívás túllépte az időkorlátot.
HOST_E_NOT_OWNER	A hívó nem rendelkezik a zárral.
HOST_E_ABANDONED	Egy esemény megszakadt, miközben egy blokkolt szál vagy szál várt rá.
E_FAIL	Ismeretlen katasztrofális hiba történt. Amikor egy metódus E_FAIL ad vissza, a CLR már nem használható a folyamaton belül. Az üzemeltetési módszerek későbbi hívásai HOST_E_CLRNOTAVAILABLE ad vissza.

Megjegyzések

GetMemoryLoad burkolja a Win32 GlobalMemoryStatus függvényt. Az értéke pMemoryLoad a függvény által GlobalMemoryStatusvisszaadott struktúra mezőjének MEMORYSTATUS megfelelőjedwMemoryLoad.

A futtatókörnyezet a visszatérési értéket heurisztikusként használja a szemétgyűjtőhöz. Ha például a gazdagép arról számol be, hogy a memória nagy része használatban van, a szemétgyűjtő dönthet úgy, hogy több generációból gyűjti össze a memória mennyiségét, ami potenciálisan elérhetővé válhat.

Követelmények

Platformok: Lásd: Rendszerkövetelmények.

Fejléc: MSCorEE.h

Könyvtár: Erőforrásként szerepel a MSCorEE.dll

.NET-keretrendszer verziók: 2.0 óta elérhető

Lásd még

• System.GC
• IHostMemoryManager felület