Partager via

COR_GC_STATS, structure

  • Article

Fournit des statistiques sur le mécanisme de garbage collection du Common Language Runtime (CLR).

Syntaxe

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;

Membres

Membre Description
Flags Indique quelles valeurs de champ doivent être calculées et retournées.
ExplicitGCCount Indique le nombre de garbage collections qui ont été forcées par une demande externe.
GenCollectionsTaken Indique le nombre de garbage collections effectuées pour chaque génération.
CommittedKBytes Nombre total de kilo-octets validés dans tous les tas.
ReservedKBytes Nombre total de kilo-octets réservés dans tous les tas.
Gen0HeapSizeKBytes Taille en kilo-octets du tas de génération zéro.
Gen1HeapSizeKBytes Taille en kilo-octets du tas de génération un.
Gen2HeapSizeKBytes Taille en kilo-octets du tas de génération deux.
LargeObjectHeapSizeKBytes Taille en kilo-octets du tas des grands objets.
KBytesPromotedFromGen0 Taille en kilo-octets des objets promus de la génération zéro à la génération un.
KBytesPromotedFromGen1 Taille en kilo-octets des objets promus de la génération un à la génération deux.

Remarques

La méthode ICLRGCManager::GetStats nécessite que le champ Flags de la structure COR_GC_STATS soit défini sur une ou plusieurs valeurs de l’énumération COR_GC_STAT_TYPES pour spécifier les statistiques à définir.

Le tableau suivant mappe les statistiques fournies par cette structure aux deux valeurs de l’énumération COR_GC_STAT_TYPES, COR_GC_COUNTS et COR_GC_MEMORYUSAGE.

Spécifié par COR_GC_COUNTS Spécifié par COR_GC_MEMORYUSAGE
ExplicitGCCount

GenCollectionsTaken		 CommittedKBytes

ReservedKBytes

Gen0HeapSizeKBytes

Gen1HeapSizeKBytes

Gen2HeapSizeKBytes

LargeObjectHeapSizeKBytes

KBytesPromotedFromGen0

KBytesPromotedFromGen1

Voici un exemple d’utilisation :

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

Configuration requise

Plateformes : Consultez Configuration requise.

En-tête : GCHost.idl

Bibliothèque : incluse en tant que ressource dans MsCorEE.dll

Versions de .NET Framework : Disponible depuis la version 1.0

Voir aussi