ICLRMemoryNotificationCallback::OnMemoryNotification, méthode

Article
08/10/2011

Avertit le Common Language Runtime (CLR) du chargement de la mémoire sur l'ordinateur.

HRESULT OnMemoryNotification (
    [in] EMemoryAvailable eMemoryAvailable
);

Paramètres

eMemoryAvailable
[in] Une des valeurs EMemoryAvailable, indiquant la sollicitation actuelle de la mémoire sur l'ordinateur.

Valeur de retour

HRESULT	Description
S_OK	OnMemoryNotification a été retourné avec succès.
HOST_E_CLRNOTAVAILABLE	Le CLR n'a pas été chargé dans un processus ou le CLR présente un état dans lequel il ne peut pas exécuter de code managé ou traiter l'appel avec succès.
HOST_E_TIMEOUT	L'appel a expiré.
HOST_E_NOT_OWNER	L'appelant ne possède pas le verrou.
HOST_E_ABANDONED	Un événement a été annulé alors qu'un thread bloqué ou une fibre l'attendait.
E_FAIL	Une défaillance grave et inconnue s'est produite. Lorsqu'une méthode retourne E_FAIL, le CLR n'est plus utilisable dans le processus. Les appels suivants aux méthodes d'hébergement retournent HOST_E_CLRNOTAVAILABLE.

Notes

Le CLR enregistre 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 lorsque l'hôte signale que les ressources en termes de mémoire sont faibles.