Estrutura COR_GC_STATS

  • Artigo

Fornece estatísticas sobre o mecanismo de libertação da memória do runtime de linguagem comum (CLR).

Syntax

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 Description
Flags Indica que valores de campo devem ser calculados e devolvidos.
ExplicitGCCount Indica o número de libertações de lixo que foram forçadas por pedido externo.
GenCollectionsTaken Indica o número de libertações de lixo efetuadas para cada geração.
CommittedKBytes O número total de kilobytes consolidados em todas as áreas dinâmicas.
ReservedKBytes O número total de quilobytes reservados em todas as áreas dinâmicas.
Gen0HeapSizeKBytes O tamanho, em quilobytes, da área dinâmica para dados de geração zero.
Gen1HeapSizeKBytes O tamanho, em quilobytes, da pilha de geração um.
Gen2HeapSizeKBytes O tamanho, em quilobytes, da área dinâmica para dados de geração dois.
LargeObjectHeapSizeKBytes O tamanho, em quilobytes, da grande área dinâmica para dados de objetos.
KBytesPromotedFromGen0 O tamanho, em quilobytes, dos objetos promovidos da geração zero à geração um.
KBytesPromotedFromGen1 O tamanho, em quilobytes, dos objetos promovidos da geração um para a geração dois.

Observações

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

A tabela seguinte mapeia as estatísticas fornecidas por esta estrutura para os dois valores COR_GC_COUNTS de enumeração COR_GC_STAT_TYPES 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 da utilização é o seguinte:

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

Requisitos

Plataformas: Veja Requisitos de Sistema.

Cabeçalho: GCHost.idl

Biblioteca: Incluído como um recurso no MSCorEE.dll

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

Ver também