ICLRMemoryNotificationCallback::OnMemoryNotification (Método)

Artículo
08/10/2011

Notifica a Common Language Runtime (CLR) la carga de memoria en el equipo.

HRESULT OnMemoryNotification (
    [in] EMemoryAvailable eMemoryAvailable
);

Parámetros

eMemoryAvailable
[in] Uno de los valores de EMemoryAvailable, que indica la necesidad de memoria que está experimentando el equipo.

Valor devuelto

HRESULT	Descripción
S_OK	OnMemoryNotification finalizó correctamente.
HOST_E_CLRNOTAVAILABLE	CLR no se ha cargado en un proceso o está en un estado en el que no puede ejecutar el código administrado o procesar la llamada correctamente.
HOST_E_TIMEOUT	Se agotó el tiempo de espera de la llamada.
HOST_E_NOT_OWNER	El llamador no posee el bloqueo.
HOST_E_ABANDONED	Se canceló un evento mientras una fibra o un subproceso bloqueado estaba esperándole.
E_FAIL	Se ha producido un error catastrófico desconocido. Cuando un método devuelve E_FAIL, CLR no se puede seguir utilizando en el proceso. Las llamadas subsiguientes a métodos de hospedaje devuelven HOST_E_CLRNOTAVAILABLE.

Comentarios

CLR registra una devolución de llamada a OnMemoryNotification mediante una llamada al método IHostMemoryManager::RegisterMemoryNotificationCallback. El motor en tiempo de ejecución utiliza la información devuelta en la devolución de llamada para liberar memoria adicional cuando el host informa que hay pocos recursos de memoria.