ICLRMemoryNotificationCallback::OnMemoryNotification (Método)

Actualización: noviembre 2007

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 se devolvió 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 irrecuperable 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.

Nota

Las llamadas a OnMemoryNotification nunca se bloquean. Siempre vuelven inmediatamente.