Partilhar via


Método IHostMemoryManager::RegisterMemoryNotificationCallback

Registra um ponteiro para uma função de retorno de chamada que invoca o host para notificar o Common linguagem tempo de execução (CLR) de memória corrente carga no computador.

HRESULT RegisterMemoryNotificationCallback (
    [in] ICLRMemoryNotificationCallback* pCallback
);

Parâmetros

Valor de retorno

HRESULT

Descrição

S_OK

RegisterMemoryNotificationCallback retornado com êxito.

HOST_E_CLRNOTAVAILABLE

O CLR não foi carregado em um processo ou o CLR está em um estado em que ele não possa executar código gerenciado ou processar a telefonar com êxito.

HOST_E_TIMEOUT

A telefonar expirou.

HOST_E_NOT_OWNER

O chamador não é proprietário do bloquear.

HOST_E_ABANDONED

Um evento foi cancelado enquanto um segmento bloqueado ou fibra estava aguardando nele.

E_FAIL

Ocorreu uma falha catastrófica desconhecida. Quando um método retorna E_FAIL, o CLR não é mais útil dentro do processo. As chamadas subseqüentes à hospedagem 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 instância fornecida pelo CLR, o inscrição é eficaz para a função de retorno de chamada. O host chama OnMemoryNotification para relatar condições de pressão de memória, em vez de usar do Win32 padrão CreateMemoryResourceNotification função. Para obter mais informações, consulte a documentação da plataforma Windows.

ObservaçãoObservação:

Chamadas para OnMemoryNotification nunca bloco. Eles sempre retornam imediatamente.

Requisitos

Plataformas: See Requisitos de sistema do .NET framework.

Cabeçalho: MSCorEE.idl

Biblioteca: Incluído sistema autônomo um recurso em MSCorEE.dll

.NET Framework Versions: 3.5 SP1, 3,5, 3.0 SP1, 3.0, 2.0 SP1, 2.0

Consulte também

Referência

Interface ICLRMemoryNotificationCallback

Interface IHostMemoryManager