Método de ICLRMemoryNotificationCallback::OnMemoryNotification

Artigo
08/08/2011

Notifica o common language runtime (CLR) da carga de memória no computador.

HRESULT OnMemoryNotification (
    [in] EMemoryAvailable eMemoryAvailable
);

Parâmetros

eMemoryAvailable
[in] Dentre as EMemoryAvailable valores, indicando a pressão de memória do computador está enfrentando atualmente.

Valor de retorno

HRESULT	Descrição
S_OK	OnMemoryNotificationretornado com êxito.
HOST_E_CLRNOTAVAILABLE	O CLR não foi carregado em um processo ou o CLR é em um estado em que ele não é possível executar código gerenciado ou processar a chamada com êxito.
HOST_E_TIMEOUT	A chamada foi esgotado.
HOST_E_NOT_OWNER	O chamador não possui o bloqueio.
HOST_E_ABANDONED	Um evento foi cancelado, enquanto um segmento bloqueado ou fibra estava esperando por ele.
E_FAIL	Ocorreu uma falha catastrófica desconhecida. Depois de um método retornar E_FAIL, o CLR não é usável dentro do processo. As chamadas subseqüentes para hospedar os métodos retornam HOST_E_CLRNOTAVAILABLE.

Comentários

O CLR registra um retorno de chamada para OnMemoryNotification usando uma chamada para o IHostMemoryManager::RegisterMemoryNotificationCallback método. O runtime usa as informações retornadas no retorno de chamada para liberar memória adicional quando o host relata que executam baixos recursos de memória.

Observação

Chamadas para OnMemoryNotification nunca bloco.Eles sempre retornam imediatamente.