ICorProfilerCallback2::GarbageCollectionStarted-Methode

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, CorProf.h

Bibliothek: CorGuids.lib

.NET Framework-Versionen: 4, 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0

Siehe auch

Referenz

ICorProfilerCallback-Schnittstelle

ICorProfilerCallback2-Schnittstelle