ICLRMemoryNotificationCallback::OnMemoryNotification, méthode
Avertit le Common Language Runtime (CLR) de la charge de la mémoire sur l’ordinateur.
Syntaxe
HRESULT OnMemoryNotification (
[in] EMemoryAvailable eMemoryAvailable
);
Paramètres
eMemoryAvailable
[in] Une des valeurs EMemoryAvailable, indiquant la pression de mémoire que subit actuellement l’ordinateur.
Valeur de retour
HRESULT | Description |
---|---|
S_OK | OnMemoryNotification retourné. |
HOST_E_CLRNOTAVAILABLE | Le CLR n’a pas été chargé dans un processus ou son état ne lui permet pas d’exécuter du code managé ni de traiter l’appel correctement. |
HOST_E_TIMEOUT | L’appel a expiré. |
HOST_E_NOT_OWNER | L’appelant n’est pas propriétaire du verrou. |
HOST_E_ABANDONED | Un événement a été annulé alors qu’un thread ou une fibre bloqué l’attendait. |
E_FAIL | Une défaillance catastrophique inconnue s’est produite. Après qu’une méthode retourne E_FAIL, le CLR n’est plus utilisable dans le processus. Les appels suivants aux méthodes d’hébergement renvoient HOST_E_CLRNOTAVAILABLE. |
Notes
Le CLR inscrit un rappel à OnMemoryNotification
en utilisant un appel à la méthode IHostMemoryManager::RegisterMemoryNotificationCallback. Le runtime utilise les informations retournées dans le rappel pour libérer de la mémoire supplémentaire quand l’hôte signale que les ressources de mémoire sont insuffisantes.
Notes
Les appels à OnMemoryNotification
ne se bloquent jamais. Ils retournent toujours immédiatement.
Spécifications
Plateformes : Consultez Configuration requise.
En-tête : MSCorEE.h
Bibliothèque : incluse en tant que ressource dans MsCorEE.dll
Versions de .NET Framework : Disponible depuis la version 2.0