ICLRMemoryNotificationCallback::OnMemoryNotification-Methode
Benachrichtigt die Common Language Runtime (CLR) über die Arbeitsspeicherauslastung auf dem Computer
Syntax
HRESULT OnMemoryNotification (
[in] EMemoryAvailable eMemoryAvailable
);
Parameter
eMemoryAvailable
[in] Einer der EMemoryAvailable-Werte, der angibt, wie hoch die Arbeitsspeicherauslastung des Computers derzeit ist.
Rückgabewert
| HRESULT | BESCHREIBUNG |
|---|---|
| S_OK | OnMemoryNotification wurde erfolgreich zurückgegeben. |
| HOST_E_CLRNOTAVAILABLE | Die CLR wurde nicht in einen Prozess geladen, oder die CLR befindet sich in einem Zustand, in dem sie keinen verwalteten Code ausführen oder den Aufruf nicht erfolgreich verarbeiten kann. |
| HOST_E_TIMEOUT | Timeout des Aufrufs. |
| HOST_E_NOT_OWNER | Der Aufrufer besitzt die Sperre nicht. |
| HOST_E_ABANDONED | Ein Ereignis wurde abgebrochen, während ein blockierter Thread oder eine blockierte Fiber darauf gewartet hat. |
| E_FAIL | Es ist ein unbekannter katastrophaler Fehler aufgetreten. Wenn eine Methode „E_FAIL“ zurückgibt, kann die CLR nicht mehr innerhalb des Prozesses verwendet werden. Nachfolgende Aufrufe von Hostingmethoden geben HOST_E_CLRNOTAVAILABLE zurück. |
Bemerkungen
Die CLR registriert einen Rückruf zu OnMemoryNotification mithilfe eines Aufrufs der Methode IHostMemoryManager::RegisterMemoryNotificationCallback. Die Runtime verwendet die im Rückruf zurückgegebenen Informationen, um zusätzlichen Arbeitsspeicher freizugeben, wenn der Host meldet, dass die Speicherressourcen knapp werden.
Hinweis
OnMemoryNotification-Aufrufe werden nie blockiert. Sie werden immer sofort zurückgegeben.
Anforderungen
Plattformen: Informationen finden Sie unter Systemanforderungen.
Header: MSCorEE.h
Bibliothek: Als Ressource in „MsCorEE.dll“ enthalten.
.NET Framework-Versionen: Seit 2.0 verfügbar.
