Partilhar via

Método IHostMemoryManager::RegisterMemoryNotificationCallback

Regista um ponteiro numa função de chamada de retorno que o anfitrião invoca para notificar o runtime de idioma comum (CLR) da carga de memória atual no computador.

Sintaxe

HRESULT RegisterMemoryNotificationCallback (  
    [in] ICLRMemoryNotificationCallback* pCallback  
);

Parâmetros

pCallback
[in] Um ponteiro de interface para uma instância ICLRMemoryNotificationCallback que é implementada pelo CLR.

Devolver Valor

HRESULT Description
S_OK RegisterMemoryNotificationCallback 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. Quando um método devolve 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

Uma vez que a ICLRMemoryNotificationCallback interface define apenas um método (ICLRMemoryNotificationCallback::OnMemoryNotification) e porque pCallback é um ponteiro para uma ICLRMemoryNotificationCallback instância fornecida pelo CLR, o registo é efetivamente para a própria função de chamada de retorno. O anfitrião invoca OnMemoryNotification para comunicar as condições de pressão da memória, em vez de utilizar a função Win32 CreateMemoryResourceNotification padrão. Para obter mais informações, veja a documentação da Plataforma do Windows.

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

Ver também

  • Last updated on