Sdílet prostřednictvím

ICorProfilerCallback2::GarbageCollectionStarted – metoda

  • Článek

Upozorní profiler kódu, že bylo spuštěno uvolňování paměti.

Syntaxe

HRESULT GarbageCollectionStarted(  
    [in] int cGenerations,  
    [in, size_is(cGenerations), length_is(cGenerations)] BOOL generationCollected[],  
    [in] COR_PRF_GC_REASON reason);

Parametry

cGenerations
[v] Celkový počet položek v matici generationCollected .

generationCollected
[v] Pole logických hodnot, které jsou true , pokud je generování odpovídající indexu pole shromažďováno tímto uvolňováním paměti; v opačném případě false.

Pole je indexováno hodnotou COR_PRF_GC_GENERATION výčtu, která označuje generování.

reason
[v] Hodnota COR_PRF_GC_REASON výčtu, který označuje důvod, proč bylo uvolňování paměti vyvolána.

Poznámky

Všechna zpětná volání, která se týkají tohoto uvolňování paměti, dojde mezi GarbageCollectionStarted zpětné volání a odpovídající ICorProfilerCallback2::GarbageCollectionFinished zpětné volání. Tato zpětná volání nemusí nacházet ve stejném vlákně.

Profiler může během GarbageCollectionStarted zpětného volání bezpečně kontrolovat objekty v jejich původních umístěních. Systém uvolňování paměti začne přesouvat objekty po návratu z GarbageCollectionStarted. Po vrácení profileru z tohoto zpětného volání by měl profiler považovat všechna ID objektů za neplatná, dokud neobdrží ICorProfilerCallback2::GarbageCollectionFinished zpětné volání.

Požadavky

Platformy: Viz Požadavky na systém.

Záhlaví: CorProf.idl, CorProf.h

Knihovny: CorGuids.lib

Verze rozhraní .NET Framework: K dispozici od verze 2.0

Viz také