Struttura COR_GC_STATS

  • Articolo

Fornisce statistiche sul meccanismo di Garbage Collection di Common Language Runtime (CLR).

Sintassi

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;

Members

Membro Descrizione
Flags Indica quali valori di campo devono essere calcolati e restituiti.
ExplicitGCCount Indica il numero di Garbage Collection forzati dalla richiesta esterna.
GenCollectionsTaken Indica il numero di Garbage Collection eseguiti per ogni generazione.
CommittedKBytes Numero totale di kilobyte di cui è stato eseguito il commit in tutti gli heap.
ReservedKBytes Numero totale di kilobyte riservati in tutti gli heap.
Gen0HeapSizeKBytes Dimensione, espressa in kilobyte, dell'heap di generazione zero.
Gen1HeapSizeKBytes Dimensione, in kilobyte, dell'heap di prima generazione.
Gen2HeapSizeKBytes Dimensione, in kilobyte, dell'heap di seconda generazione.
LargeObjectHeapSizeKBytes Dimensione, in kilobyte, dell'heap di oggetti di grandi dimensioni.
KBytesPromotedFromGen0 Dimensione, espressa in kilobyte, degli oggetti promossi dalla generazione zero alla generazione 1.
KBytesPromotedFromGen1 Dimensioni, in kilobyte, degli oggetti promossi dalla generazione 1 alla seconda generazione.

Commenti

Il metodo ICLRGCManager::GetStats richiede che il Flags campo della COR_GC_STATS struttura sia impostato su uno o più valori dell'enumerazione COR_GC_STAT_TYPES per specificare le statistiche da impostare.

Nella tabella seguente vengono mappate le statistiche fornite da questa struttura ai due valori di enumerazione COR_GC_STAT_TYPES e COR_GC_COUNTSCOR_GC_MEMORYUSAGE.

Specificato da COR_GC_COUNTS Specificato da COR_GC_MEMORYUSAGE
ExplicitGCCount

GenCollectionsTaken		 CommittedKBytes

ReservedKBytes

Gen0HeapSizeKBytes

Gen1HeapSizeKBytes

Gen2HeapSizeKBytes

LargeObjectHeapSizeKBytes

KBytesPromotedFromGen0

KBytesPromotedFromGen1

Di seguito è riportato un esempio di utilizzo:

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

Requisiti

Piattaforme: vedere Requisiti di sistema di .NET Framework.

Intestazione: GCHost.idl

Libreria: Incluso come risorsa in MSCorEE.dll

Versioni di .NET Framework: Disponibile dalla versione 1.0

Vedi anche