Método de IHostMemoryManager::RegisterMemoryNotificationCallback
Registra um ponteiro para uma função de retorno de chamada que o host chama para notificar o common language runtime (CLR) da carga atual de memória no computador.
HRESULT RegisterMemoryNotificationCallback (
[in] ICLRMemoryNotificationCallback* pCallback
);
Parâmetros
- pCallback
[in] Um ponteiro de interface para um ICLRMemoryNotificationCallback instância é implementada pelo CLR.
Valor de retorno
HRESULT |
Descrição |
|---|---|
S_OK |
RegisterMemoryNotificationCallbackretornado 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. Quando um método retorna 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
Porque o ICLRMemoryNotificationCallback interface define apenas um método (ICLRMemoryNotificationCallback::OnMemoryNotification) e porque pCallback é um ponteiro para um ICLRMemoryNotificationCallback fornecido pelo CLR, o registro é eficaz para a função de retorno de chamada de instância. O host chama OnMemoryNotification para relatar condições de pressão de memória, em vez de usar o Win32 padrão CreateMemoryResourceNotification função. Para obter mais informações, consulte a documentação da plataforma Windows.
Observação
Chamadas para OnMemoryNotification nunca bloco.Eles sempre retornam imediatamente.
Requisitos
Plataformas: Consulte Requisitos de sistema do .NET Framework.
Cabeçalho: MSCorEE.h
Biblioteca: Incluído como um recurso em mscoree
.NET Framework versões: 4, 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0