ICorProfilerCallback2::GarbageCollectionStarted-Methode
Aktualisiert: November 2007
Benachrichtigt den Codeprofiler, dass eine Garbage Collection gestartet wurde.
HRESULT GarbageCollectionStarted(
[in] int cGenerations,
[in, size_is(cGenerations), length_is(cGenerations)] BOOL generationCollected[],
[in] COR_PRF_GC_REASON reason);
Parameter
cGenerations
[in] Die Gesamtanzahl der Einträge im generationCollected-Array.generationCollected
[in] Ein Array von booleschen Werten, die true sind, wenn die Generierung, die dem Arrayindex entspricht, von dieser Garbage Collection gesammelt wird; andernfalls sind die Werte false.Das Array wird von einem Wert der COR_PRF_GC_GENERATION-Enumeration indiziert, der die Generierung angibt.
reason
[in] Ein Wert der COR_PRF_GC_REASON-Enumeration, der den Grund dafür angibt, dass die Garbage Collection ausgelöst wurde.
Hinweise
Alle Rückrufe in Bezug auf diese Garbage Collection treten zwischen dem GarbageCollectionStarted-Rückruf und dem entsprechenden ICorProfilerCallback2::GarbageCollectionFinished-Rückruf auf. Diese Rückrufe müssen nicht auf dem gleichen Thread erfolgen.
Der Profiler kann Objekte sicher an ihren ursprünglichen Speicherorten während des GarbageCollectionStarted-Rückrufs überprüfen. Der Garbage Collector beginnt mit dem Verschieben von Objekten, nachdem GarbageCollectionStarted zurückgegeben wurde. Nachdem der Profiler von diesem Rückruf zurückgegeben wurde, sollte der Profiler alle Objekt-IDs als ungültig ansehen, bis er einen ICorProfilerCallback2::GarbageCollectionFinished-Rückruf empfängt.
Anforderungen
Plattformen: siehe Systemanforderungen für .NET Framework.
Header: CorProf.idl
Bibliothek: CorGuids.lib
.NET Framework-Versionen: 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0