ICorProfilerCallback2::GarbageCollectionStarted-metod

Meddelar kodprofileraren att skräpinsamlingen har startat.

Syntax

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

Parametrar

cGenerations
[i] Det totala antalet poster i matrisen generationCollected .

generationCollected
[i] En matris med booleska värden, som är true om genereringen som motsvarar matrisindexet samlas in av den här skräpinsamlingen, falseannars .

Matrisen indexeras med ett värde för COR_PRF_GC_GENERATION uppräkning, vilket anger genereringen.

reason
[i] Ett värde för COR_PRF_GC_REASON uppräkning som anger orsaken till att skräpinsamlingen inducerades.

Kommentarer

Alla återanrop som gäller den här skräpinsamlingen sker mellan återanropet GarbageCollectionStarted och motsvarande ICorProfilerCallback2::GarbageCollectionFinished-återanrop . Dessa återanrop behöver inte ske i samma tråd.

Det är säkert för profileraren att inspektera objekt på sina ursprungliga platser under återanropet GarbageCollectionStarted . Skräpinsamlaren börjar flytta objekt efter returen från GarbageCollectionStarted. När profileraren har återvänt från det här återanropet bör profileraren betrakta alla objekt-ID:er som ogiltiga tills den får ett ICorProfilerCallback2::GarbageCollectionFinished återanrop.

Krav

Plattformar: Se Systemkrav.

Huvudet: CorProf.idl, CorProf.h

Bibliotek: CorGuids.lib

.NET Framework versioner: Tillgänglig sedan 2.0

Se även

• ICorProfilerCallback-gränssnitt
• ICorProfilerCallback2-gränssnitt