COR_GC_STATS 構造体

  • [アーティクル]

共通言語ランタイム (CLR) のガベージ コレクション機構に関する統計を提供します。

構文

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;

メンバー

メンバー 説明
Flags 計算されて返されるフィールド値を示します。
ExplicitGCCount 外部要求によって強制的に実行されたガベージ コレクションの数を示します。
GenCollectionsTaken 世代ごとに実行されるガベージ コレクションの数を示します。
CommittedKBytes すべてのヒープでコミットされた合計キロバイト数。
ReservedKBytes すべてのヒープで予約された合計キロバイト数。
Gen0HeapSizeKBytes 世代 0 のヒープのサイズ (KB 単位)。
Gen1HeapSizeKBytes 世代 1 のヒープのサイズ (KB 単位)。
Gen2HeapSizeKBytes 世代 2 のヒープのサイズ (KB 単位)。
LargeObjectHeapSizeKBytes 大きなオブジェクト ヒープのサイズ (KB 単位)。
KBytesPromotedFromGen0 世代 0 から世代 1 に昇格されたオブジェクトのサイズ (KB 単位)。
KBytesPromotedFromGen1 世代 1 から世代 2 に昇格されたオブジェクトのサイズ (KB 単位)。

解説

設定される統計を指定するには、ICLRGCManager::GetStats メソッドで、Flags 構造体の COR_GC_STATS フィールドを COR_GC_STAT_TYPES 列挙型の 1 つ以上の値に設定する必要があります。

次の表では、この構造体で提供される統計が 2 つの COR_GC_STAT_TYPES 列挙値 (COR_GC_COUNTS と COR_GC_MEMORYUSAGE) にマップされています。

COR_GC_COUNTS で指定 COR_GC_MEMORYUSAGE で指定
ExplicitGCCount

GenCollectionsTaken		 CommittedKBytes

ReservedKBytes

Gen0HeapSizeKBytes

Gen1HeapSizeKBytes

Gen2HeapSizeKBytes

LargeObjectHeapSizeKBytes

KBytesPromotedFromGen0

KBytesPromotedFromGen1

使用例は次のとおりです。

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

必要条件

:「システム要件」を参照してください。

ヘッダー: GCHost

ライブラリ: MSCorEE.dll にリソースとして含まれます

.NET Framework のバージョン: 1.0 以降で使用可能

関連項目