Compartilhar via

Estrutura COR_GC_STATS

  • Artigo

Fornece as estatísticas sobre o mecanismo de coleta de lixo do CLR (Common Language Runtime).

Sintaxe

typedef struct _COR_GC_STATS {  
    ULONG   Flags;
    SIZE_T  ExplicitGCCount;  
    SIZE_T  GenCollectionsTaken[3];  
    SIZE_T  CommittedKBytes;
    SIZE_T  ReservedKBytes;  
    SIZE_T  Gen0HeapSizeKBytes;  
    SIZE_T  Gen1HeapSizeKBytes;  
    SIZE_T  Gen2HeapSizeKBytes;  
    SIZE_T  LargeObjectHeapSizeKBytes;  
    SIZE_T  KBytesPromotedFromGen0;  
    SIZE_T  KBytesPromotedFromGen1;  
} COR_GC_STATS;

Membros

Membro DESCRIÇÃO
Flags Indica quais valores de campo devem ser calculados e retornados.
ExplicitGCCount Indica o número de coletas de lixo que foram forçadas por solicitação externa.
GenCollectionsTaken Indica o número de coletas de lixo executadas para cada geração.
CommittedKBytes O número total de quilobytes confirmados em todos os heaps.
ReservedKBytes O número total de quilobytes reservados em todos os heaps.
Gen0HeapSizeKBytes O tamanho, em quilobytes, do heap de geração zero.
Gen1HeapSizeKBytes O tamanho, em quilobytes, do heap de geração um.
Gen2HeapSizeKBytes O tamanho, em quilobytes, do heap de geração dois.
LargeObjectHeapSizeKBytes O tamanho, em quilobytes, do heap de objetos grandes.
KBytesPromotedFromGen0 O tamanho, em quilobytes, dos objetos promovidos da geração zero para a geração um.
KBytesPromotedFromGen1 O tamanho, em quilobytes, dos objetos promovidos da geração um para a geração dois.

Comentários

O método ICLRGCManager::GetStats requer que o campo Flags da estrutura COR_GC_STATS seja definido como um ou mais valores da enumeração COR_GC_STAT_TYPES para especificar quais estatísticas devem ser definidas.

A tabela a seguir mapeia as estatísticas fornecidas por essa estrutura para os dois valores de enumeração COR_GC_STAT_TYPESCOR_GC_COUNTS e COR_GC_MEMORYUSAGE.

Especificado por COR_GC_COUNTS Especificado por COR_GC_MEMORYUSAGE
ExplicitGCCount

GenCollectionsTaken		 CommittedKBytes

ReservedKBytes

Gen0HeapSizeKBytes

Gen1HeapSizeKBytes

Gen2HeapSizeKBytes

LargeObjectHeapSizeKBytes

KBytesPromotedFromGen0

KBytesPromotedFromGen1

Um exemplo do uso é o seguinte:

COR_GC_STATS GCStats;  
GCStats.Flags = COR_GC_COUNTS | COR_GC_MEMORYUSAGE;  
pCLRGCManager->GetStats(&GCStats);

Requisitos

Plataformas: confira Requisitos do sistema.

Cabeçalho: GCHost.idl

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

Versões do .NET Framework: Disponível desde 1.0

Confira também