ICorProfilerCallback2::GarbageCollectionStarted metódus

Értesíti a kódprofilozót, hogy a szemétgyűjtés elindult.

Szintaxis

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

Paraméterek

cGenerations
[in] A tömb bejegyzéseinek generationCollected teljes száma.

generationCollected
[in] Logikai értékek tömbje, amely akkor jelenik true meg, ha a tömbindexnek megfelelő generációt gyűjti össze ez a szemétgyűjtés; ellenkező esetben false: .

A tömb indexelése a COR_PRF_GC_GENERATION enumerálás értékével történik, amely a generációt jelzi.

reason
[in] A COR_PRF_GC_REASON enumerálás értéke, amely a szemétgyűjtés kiváltó okát jelzi.

Megjegyzések

A szemétgyűjtéshez kapcsolódó visszahívások a visszahívás és a GarbageCollectionStarted megfelelő ICorProfilerCallback2::GarbageCollectionFinished visszahívás között történnek. Ezeknek a visszahívásoknak nem kell ugyanazon a szálon történniük.

A visszahívás során a profilkészítő biztonságosan megvizsgálhatja az GarbageCollectionStarted eredeti helyükön lévő objektumokat. A szemétgyűjtő a visszatérés után megkezdi az objektumok áthelyezését GarbageCollectionStarted. Miután a profilkészítő visszatért ebből a visszahívásból, a profilkészítőnek az összes objektumazonosítót érvénytelennek kell tekintenie, amíg visszahívást nem kap ICorProfilerCallback2::GarbageCollectionFinished .

Követelmények

Platformok: Lásd: Rendszerkövetelmények.

Fejléc: CorProf.idl, CorProf.h

Könyvtár: CorGuids.lib

.NET-keretrendszer verziók: 2.0 óta elérhető

Lásd még

• ICorProfilerCallback felület
• ICorProfilerCallback2 felület