Udostępnij za pośrednictwem

IHostMemoryManager::RegisterMemoryNotificationCallback — Metoda

  • Artykuł

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

Zobacz też