Edit

Share via

COR_PRF_GC_GENERATION_RANGE Structure

  • Article

Describes a range (that is, block) of memory that is undergoing garbage collection.

Syntax

typedef struct COR_PRF_GC_GENERATION_RANGE {  
    COR_PRF_GC_GENERATION generation;  
    ObjectID rangeStart;  
    UINT_PTR rangeLength;  
    UINT_PTR rangeLengthReserved;  
} COR_PRF_GC_GENERATION_RANGE;

Members

Member Description
generation A value of the COR_PRF_GC_GENERATION enumeration that specifies the generation to which the block of memory belongs.
rangeStart The ID of an object that specifies the starting location of the block of memory.
rangeLength A pointer to an integer that specifies the size of the used portion of the memory block (that is, the amount of memory used within the block).
rangeLengthReserved A pointer to an integer that specifies the size of the memory block (that is, the amount of memory reserved for the block).

Remarks

The rangeLength value is guaranteed to be accurate only if ICorProfilerInfo2::GetGenerationBounds or ICorProfilerInfo2::GetObjectGeneration, both of which use the COR_PRF_GC_GENERATION_RANGE structure, is called from the ICorProfilerCallback2::GarbageCollectionStarted or the ICorProfilerCallback2::GarbageCollectionFinished method.

Requirements

Platforms: See System Requirements.

Header: CorProf.idl

Library: CorGuids.lib

.NET Framework Versions: Available since 2.0

See also