IHostMemoryManager::RegisterMemoryNotificationCallback (Método)

Artículo
08/10/2011

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

HRESULT RegisterMemoryNotificationCallback (
    [in] ICLRMemoryNotificationCallback* pCallback
);

Parámetros

pCallback
[in] Puntero de interfaz a una instancia de ICLRMemoryNotificationCallback implementada por CLR.

Valor devuelto

HRESULT	Descripción
S_OK	RegisterMemoryNotificationCallback 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. Si 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

Dado que la interfaz ICLRMemoryNotificationCallback sólo define un método (ICLRMemoryNotificationCallback::OnMemoryNotification) y que pCallback es un puntero a una instancia de ICLRMemoryNotificationCallback proporcionada por CLR, el registro se realiza en realidad para la propia función de devolución de llamada. El host invoca a OnMemoryNotification para informar sobre las condiciones de necesidad de memoria, en lugar de utilizar la función CreateMemoryResourceNotification estándar de Win32. Para obtener más información, consulte la documentación sobre la plataforma Windows.