IHostMemoryManager::RegisterMemoryNotificationCallback, méthode

Article
08/10/2011

Enregistre un pointeur vers une fonction de rappel que l'hôte appelle pour avertir le Common Language Runtime (CLR) du chargement en cours de la mémoire sur l'ordinateur.

HRESULT RegisterMemoryNotificationCallback (
    [in] ICLRMemoryNotificationCallback* pCallback
);

Paramètres

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

Valeur de retour

HRESULT	Description
S_OK	RegisterMemoryNotificationCallback 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

Puisque 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 destinée dans les faits à 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 Win32 standard CreateMemoryResourceNotification. Pour plus d'informations, consultez la documentation de la plateforme Windows.