共用方式為

COR_GC_STATS 結構

  • 發行項

提供 Common Language Runtime (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;

成員

member 描述
Flags 指出應計算和傳回的欄位值。
ExplicitGCCount 指出外部要求強制的記憶體回收數目。
GenCollectionsTaken 指出針對每個層代執行的記憶體回收數目。
CommittedKBytes 所有堆積中認可的 KB 總數。
ReservedKBytes 所有堆積中保留的 KB 總數。
Gen0HeapSizeKBytes 層代零堆積的大小 (KB)。
Gen1HeapSizeKBytes 層代一堆積的大小 (KB)。
Gen2HeapSizeKBytes 層代二堆積的大小 (KB)。
LargeObjectHeapSizeKBytes 大型物件堆積的大小 (KB)。
KBytesPromotedFromGen0 從層代零升級至層代一的物件大小 (KB)。
KBytesPromotedFromGen1 從層代一升級至層代二的物件大小 (KB)。

備註

ICLRGCManager::GetStats 方法需要具有 COR_GC_STATS 結構的欄位 Flags 設定為一或多個 COR_GC_STAT_TYPES 列舉值，藉此指定要設定的統計資料。

下表會將這個結構所提供的統計資料對應至兩個 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.idl

程式庫：包含作為 MSCorEE.dll 中的資源

.NET Framework版本：自 1.0 起可用

另請參閱