Método ICLRMemoryNotificationCallback::OnMemoryNotification
Notifica o runtime de linguagem comum (CLR) da carga de memória no computador.
Sintaxe
HRESULT OnMemoryNotification (
[in] EMemoryAvailable eMemoryAvailable
);
Parâmetros
eMemoryAvailable
[in] Um dos valores EMemoryAvailable , que indica a pressão de memória que o computador está atualmente a ter.
Devolver Valor
HRESULT | Description |
---|---|
S_OK | OnMemoryNotification devolvido com êxito. |
HOST_E_CLRNOTAVAILABLE | O CLR não foi carregado para um processo ou o CLR está num estado em que não pode executar código gerido ou processar a chamada com êxito. |
HOST_E_TIMEOUT | A chamada excedeu o limite de tempo. |
HOST_E_NOT_OWNER | O autor da chamada não é o proprietário do bloqueio. |
HOST_E_ABANDONED | Um evento foi cancelado enquanto um thread ou fibra bloqueado estava à espera do mesmo. |
E_FAIL | Ocorreu uma falha catastrófica desconhecida. Depois de um método devolver E_FAIL, o CLR já não é utilizável no processo. As chamadas subsequentes para métodos de alojamento devolvem HOST_E_CLRNOTAVAILABLE. |
Observações
O CLR regista uma chamada de retorno para através OnMemoryNotification
de uma chamada para o método IHostMemoryManager::RegisterMemoryNotificationCallback . O runtime utiliza as informações devolvidas na chamada de retorno para libertar memória adicional quando o anfitrião comunica que os recursos de memória estão em falta.
Nota
Chamadas para OnMemoryNotification
nunca bloquear. Voltam sempre imediatamente.
Requisitos
Plataformas: Veja Requisitos do Sistema.
Cabeçalho: MSCorEE.h
Biblioteca: Incluído como um recurso no MSCorEE.dll
.NET Framework Versões: Disponível desde 2.0