Compartir vía

COR_GC_STATS (Estructura)

  • Artículo

Proporciona estadísticas sobre el mecanismo de recolección de elementos no utilizados de Common Language Runtime (CLR).

Sintaxis

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;

Miembros

Miembro Descripción
Flags Indica qué valores de campo se deben calcular y devolver.
ExplicitGCCount Indica el número de recolecciones de elementos no utilizados forzadas por solicitud externa.
GenCollectionsTaken Indica el número de recolecciones de elementos no utilizados realizadas para cada generación.
CommittedKBytes Número total de kilobytes confirmados en todos los montones.
ReservedKBytes Número total de kilobytes reservados en todos los montones.
Gen0HeapSizeKBytes Tamaño, en kilobytes, del montón de generación cero.
Gen1HeapSizeKBytes Tamaño, en kilobytes, del montón de generación uno.
Gen2HeapSizeKBytes Tamaño, en kilobytes, del montón de generación dos.
LargeObjectHeapSizeKBytes Tamaño, en kilobytes, del montón de objetos grandes.
KBytesPromotedFromGen0 Tamaño, en kilobytes, de los objetos promovidos de la generación cero a la generación uno.
KBytesPromotedFromGen1 Tamaño, en kilobytes, de los objetos promocionados de la generación uno a la generación dos.

Comentarios

El método ICLRGCManager::GetStats requiere que el campo Flags de la estructura COR_GC_STATS se establezca en uno o varios valores de la enumeración COR_GC_STAT_TYPES para especificar qué estadísticas se deben establecer.

En la tabla siguiente se asignan las estadísticas proporcionadas por esta estructura a los dos valores de enumeración COR_GC_STAT_TYPES, COR_GC_COUNTS y COR_GC_MEMORYUSAGE.

Especificado por COR_GC_COUNTS Especificado por COR_GC_MEMORYUSAGE
ExplicitGCCount

GenCollectionsTaken		 CommittedKBytes

ReservedKBytes

Gen0HeapSizeKBytes

Gen1HeapSizeKBytes

Gen2HeapSizeKBytes

LargeObjectHeapSizeKBytes

KBytesPromotedFromGen0

KBytesPromotedFromGen1

A continuación se muestra un ejemplo de la utilización:

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

Requisitos

Plataformas: Vea Requisitos de sistema.

Encabezado: GCHost.idl

Biblioteca: incluida como recurso en MSCorEE.dll

Versiones de .NET Framework: disponible a partir de la versión 1.0

Consulte también