Megosztás:


IHostMemoryManager::RegisterMemoryNotificationCallback metódus

Regisztrál egy mutatót egy visszahívási függvényre, amelyet a gazdagép meghív, hogy értesítse a közös nyelvi futtatókörnyezetet (CLR) a számítógép aktuális memóriaterheléséről.

Szintaxis

HRESULT RegisterMemoryNotificationCallback (  
    [in] ICLRMemoryNotificationCallback* pCallback  
);  

Paraméterek

pCallback
[in] A CLR által implementált ICLRMemoryNotificationCallback-példányra mutató felület.

Visszatérési érték

HRESULT Description
S_OK RegisterMemoryNotificationCallback 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árakozott 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ódszerekre irányuló későbbi hívások HOST_E_CLRNOTAVAILABLE adnak vissza.

Megjegyzések

Mivel az ICLRMemoryNotificationCallback interfész csak egy metódust definiál (ICLRMemoryNotificationCallback::OnMemoryNotification), és mivel pCallback a CLR által biztosított példányra mutat ICLRMemoryNotificationCallback , a regisztráció maga a visszahívási függvényre érvényes. A gazdagép a standard Win32 CreateMemoryResourceNotification függvény helyett memóriaterhelési feltételek jelentésére hívja OnMemoryNotification meg. További információt a Windows Platform dokumentációjában talál.

Megjegyzés

Hívás, hogy OnMemoryNotification soha ne tiltsa le. Mindig azonnal visszatérnek.

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 érhető el

Lásd még