ICLRMemoryNotificationCallback::OnMemoryNotification-Methode

Artikel
08/10/2011

Benachrichtigt die Common Language Runtime (CLR) über die Arbeitsspeicherlast auf dem Computer.

HRESULT OnMemoryNotification (
    [in] EMemoryAvailable eMemoryAvailable
);

Parameter

eMemoryAvailable
[in] Einer der EMemoryAvailable-Werte, die die momentane Arbeitsspeicherauslastung des Computers angeben.

Rückgabewert

HRESULT	Beschreibungen
S_OK	OnMemoryNotification erfolgreich zurückgegeben.
HOST_E_CLRNOTAVAILABLE	Die CLR wurde nicht in einen Prozess geladen oder befindet sich in einem Zustand, in dem sie weder verwalteten Code ausführen noch den Aufruf erfolgreich verarbeiten kann.
HOST_E_TIMEOUT	Der Aufruf hat das Zeitlimit überschritten.
HOST_E_NOT_OWNER	Der Aufrufer ist nicht Besitzer der Sperre.
HOST_E_ABANDONED	Ein Ereignis wurde abgebrochen, während ein blockierter Thread oder eine blockierte Fiber auf das Ereignis gewartet hat.
E_FAIL	Ein unbekannter, schwerwiegender Fehler ist aufgetreten. Nachdem eine Methode E_FAIL zurückgegeben hat, kann die CLR innerhalb des Prozesses nicht mehr verwendet werden. Nachfolgende Aufrufe von Hostmethoden geben HOST_E_CLRNOTAVAILABLE zurück.

Hinweise

Die CLR registriert einen Rückruf von OnMemoryNotification, indem sie einen Aufruf der IHostMemoryManager::RegisterMemoryNotificationCallback-Methode verwendet. Die Common Language Runtime verwendet die im Rückruf zurückgegebenen Informationen, um zusätzlichen Arbeitsspeicher freizugeben, wenn der Host meldet, dass Speicherressourcen zur Neige gehen.