ICLRMemoryNotificationCallback::OnMemoryNotification (Método)
Notifica a Common Language Runtime (CLR) la carga de memoria en el equipo.
Sintaxis
HRESULT OnMemoryNotification (
[in] EMemoryAvailable eMemoryAvailable
);
Parámetros
eMemoryAvailable
[in] Uno de los valores EMemoryAvailable, que indica la presión de memoria que el equipo experimenta actualmente.
Valor devuelto
| HRESULT | Descripción |
|---|---|
| S_OK | OnMemoryNotification 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 | Si se devuelve este valor, significa que ocurrió un error grave desconocido. Una vez que un método devuelva el valor E_FAIL, 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
CLR registra una devolución de llamada en OnMemoryNotification mediante una llamada al método IHostMemoryManager::RegisterMemoryNotificationCallback. El runtime usa la información devuelta en la devolución de llamada para liberar memoria adicional cuando el host informa de que hay pocos recursos de memoria.
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
