IHostMemoryManager::RegisterMemoryNotificationCallback — Metoda
Rejestruje wskaźnik do funkcji wywołania zwrotnego, którą host wywołuje w celu powiadomienia środowiska uruchomieniowego języka wspólnego (CLR) o bieżącym obciążeniu pamięci na komputerze.
Składnia
HRESULT RegisterMemoryNotificationCallback (
[in] ICLRMemoryNotificationCallback* pCallback
);
Parametry
pCallback
[w] Wskaźnik interfejsu do wystąpienia ICLRMemoryNotificationCallback implementowany przez CLR.
Wartość zwracana
HRESULT | Opis |
---|---|
S_OK | RegisterMemoryNotificationCallback 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
ICLRMemoryNotificationCallback
Ponieważ interfejs definiuje tylko jedną metodę (ICLRMemoryNotificationCallback::OnMemoryNotification), a ponieważ pCallback
jest wskaźnikiem do wystąpienia dostarczonego ICLRMemoryNotificationCallback
przez CLR, rejestracja jest efektywna dla samej funkcji wywołania zwrotnego. Host wywołuje polecenie OnMemoryNotification
w celu zgłaszania warunków ciśnienia pamięci, a nie używania standardowej funkcji Win32 CreateMemoryResourceNotification
. Aby uzyskać więcej informacji, zobacz dokumentację platformy systemu Windows.
Uwaga
Wywołania, aby nigdy nie blokować OnMemoryNotification
. Zawsze wracają natychmiast.
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