Partager via

IHostMemoryManager::RegisterMemoryNotificationCallback, méthode

Inscrit un pointeur vers une fonction de rappel appelée par l’hôte pour avertir le Common Language Runtime (CLR) de la charge de mémoire actuelle sur l’ordinateur.

Syntaxe

HRESULT RegisterMemoryNotificationCallback (  
    [in] ICLRMemoryNotificationCallback* pCallback  
);

Paramètres

pCallback
[in] Pointeur d’interface vers une instance ICLRMemoryNotificationCallback implémentée par le CLR.

Valeur de retour

HRESULT Description
S_OK RegisterMemoryNotificationCallback 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. Quand une méthode retourne E_FAIL, le CLR n’est plus utilisable au sein du processus. Les appels suivants aux méthodes d’hébergement renvoient HOST_E_CLRNOTAVAILABLE.

Notes

Étant donné que l’interface ICLRMemoryNotificationCallback définit une seule méthode (ICLRMemoryNotificationCallback::OnMemoryNotification), et comme pCallback est un pointeur vers une instance ICLRMemoryNotificationCallback fournie par le CLR, l’inscription est de fait pour la fonction de rappel elle-même. L’hôte appelle OnMemoryNotification pour signaler les conditions de sollicitation de la mémoire, plutôt que d’utiliser la fonction CreateMemoryResourceNotification Win32 standard. Pour plus d’informations, consultez la documentation de la plateforme Windows .

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

Voir aussi

  • Last updated on