Share via

Método ICLRAppDomainResourceMonitor::GetCurrentSurvived

  • Artigo

Obtém o número de bytes que sobreviveram à última coleta de lixo de bloqueio completa e que são referenciados pelo domínio do aplicativo atual.

Sintaxe

HRESULT STDMETHODCALLTYPE GetCurrentSurvived(  
             [in]  DWORD dwAppDomainId,  
             [out] ULONGLONG *pAppDomainBytesSurvived,  
             [out] ULONGLONG *pTotalBytesSurvived);

Parâmetros

dwAppDomainId
[in] A ID do domínio do aplicativo do aplicativo solicitado.

pAppDomainBytesSurvived
[out] Um ponteiro para o número de bytes que sobreviveram após a última coleta que são mantidos por esse domínio do aplicativo. Após uma coleta completa, esse número é preciso e completo. Após uma coleta efêmera, esse número é potencialmente incompleto. Esse parâmetro pode ser null.

pRuntimeBytesSurvived
[out] Um ponteiro para o número total de bytes que sobreviveram da última coleta de lixo. Após uma coleta completa, esse número representa o número de bytes que são mantidos em heaps gerenciados. Após uma coleta efêmera, esse número representa o número de bytes que são mantidos ativos em gerações efêmeras. Esse parâmetro pode ser null.

Valor Retornado

Esse método retorna os seguintes HRESULTs específicos, bem como erros HRESULT que indicam falha de método.

HRESULT Descrição
S_OK O método foi concluído com sucesso.
COR_E_APPDOMAINUNLOADED O domínio do aplicativo foi descarregado ou não existe.

Comentários

As estatísticas são atualizadas somente após uma coleta de lixo completa e bloqueada; ou seja, uma coleção que inclui todas as gerações e que interrompe o aplicativo enquanto a coleção ocorre. Por exemplo, a sobrecarga do método GC.Collect() realiza uma coleta de bloqueio completa. A coleta de lixo simultânea ocorre em segundo plano e não bloqueia o aplicativo.

O método GetCurrentSurvived é o equivalente não gerenciado da propriedade AppDomain.MonitoringSurvivedMemorySize gerenciada.

Requisitos

Plataformas: confira Requisitos do sistema.

Cabeçalho: MetaHost.h

Biblioteca: incluída como um recurso no MSCorEE.dll

Versões do .NET Framework: disponíveis desde 4

Confira também