Compartir a través de

IHostMemoryManager::RegisterMemoryNotificationCallback (Método)

  • Artículo

Registra un puntero a una función de devolución de llamada que invoca el host para notificar a Common Language Runtime (CLR) la carga de memoria actual en el equipo.

Sintaxis

HRESULT RegisterMemoryNotificationCallback (  
    [in] ICLRMemoryNotificationCallback* pCallback  
);

Parámetros

pCallback
[in] Puntero de interfaz a una instancia de ICLRMemoryNotificationCallback que ha implementado CLR.

Valor devuelto

HRESULT Descripción
S_OK RegisterMemoryNotificationCallback se devolvió correctamente.
HOST_E_CLRNOTAVAILABLE Si se devuelve este valor, significa que Common Language Runtime (CLR) no se ha cargado en un proceso o se encuentra en un estado en el que no puede ejecutar código administrado ni procesar la llamada correctamente.
HOST_E_TIMEOUT Se agotó el tiempo de espera de la llamada.
HOST_E_NOT_OWNER El autor de la llamada no es el propietario del bloqueo.
HOST_E_ABANDONED Se canceló un evento mientras que una fibra o subproceso que estaba bloqueado lo estaba esperando.
E_FAIL Ocurrió un error grave desconocido. Si un método devuelve el valor E_FAIL, el CLR ya no se podrá usar en el proceso. Las llamadas que se hagan a los métodos de hospedaje posteriormente devolverán el valor HOST_E_CLRNOTAVAILABLE.

Comentarios

Dado que la interfaz ICLRMemoryNotificationCallback define solo un método (ICLRMemoryNotificationCallback::OnMemoryNotification) y, dado que pCallback es un puntero a una instancia de ICLRMemoryNotificationCallback que proporciona CLR, el registro es eficaz para la propia función de devolución de llamada. El host invoca a OnMemoryNotification para notificar las condiciones de presión de memoria, en lugar de usar la función estándar CreateMemoryResourceNotification de Win32. Para obtener más información, vea la documentación de la Plataforma de Windows.

Nota

Las llamadas a OnMemoryNotification nunca se bloquean. Siempre devuelven un valor inmediatamente.

Requisitos

Plataformas: Vea Requisitos de sistema.

Encabezado: MSCorEE.h

Biblioteca: incluida como recurso en MSCorEE.dll

Versiones de .NET Framework: disponible a partir de la versión 2.0

Consulte también