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

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

Consulte também

Referência

Interface de ICLRMemoryNotificationCallback

Interface de IHostMemoryManager