Delen via

Methode ICorProfilerCallback2::GarbageCollectionStarted

  • Artikel

Hiermee wordt aan de code profiler aangegeven dat garbagecollection is gestart.

Syntaxis

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

Parameters

cGenerations
[in] Het totale aantal vermeldingen in de generationCollected matrix.

generationCollected
[in] Een matrix van Booleaanse waarden, die zijn true als de generatie die overeenkomt met de matrixindex wordt verzameld door deze garbagecollection; anders, false.

De matrix wordt geïndexeerd met een waarde van de opsomming COR_PRF_GC_GENERATION , die de generatie aangeeft.

reason
[in] Een waarde van de COR_PRF_GC_REASON opsomming die de reden aangeeft waarom de garbagecollection is geïnduceerd.

Opmerkingen

Alle callbacks die betrekking hebben op deze garbagecollection vinden plaats tussen de GarbageCollectionStarted callback en de bijbehorende ICorProfilerCallback2::GarbageCollectionFinished callback. Deze callbacks hoeven niet op dezelfde thread plaats te vinden.

Het is veilig voor de profiler om objecten op hun oorspronkelijke locaties te inspecteren tijdens het GarbageCollectionStarted terugbellen. De garbagecollector begint met het verplaatsen van objecten na de terugkeer van GarbageCollectionStarted. Nadat de profiler is geretourneerd door deze callback, moet de profiler alle object-id's als ongeldig beschouwen totdat deze een ICorProfilerCallback2::GarbageCollectionFinished callback ontvangt.

Vereisten

Platforms: Zie Systeemvereisten.

Header: CorProf.idl, CorProf.h

Bibliotheek: CorGuids.lib

.NET Framework versies: beschikbaar sinds 2.0

Zie ook