ICorProfilerCallback2::GarbageCollectionStarted-Methode

  • Artikel

Benachrichtigt den Codeprofiler, dass die Garbage Collection gestartet wurde.

Syntax

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 boolescher Werte, die true sind, wenn die Generierung, die dem Arrayindex entspricht, von dieser Garbage Collection erfasst wird, andernfalls false.

Das Array wird durch einen 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 angibt, warum die Garbage Collection induziert wurde.

Bemerkungen

Alle Rückrufe, die sich auf diese Garbage Collection beziehen, erfolgen zwischen dem GarbageCollectionStarted-Rückruf und dem entsprechenden ICorProfilerCallback2::GarbageCollectionFinished-Rückruf. Diese Rückrufe müssen nicht im selben Thread erfolgen.

Es ist für den Profiler sicher, Objekte während des GarbageCollectionStarted-Rückrufs an ihren ursprünglichen Speicherorten zu untersuchen. Der Garbage Collector beginnt mit dem Verschieben von Objekten nach der Rückgabe von GarbageCollectionStarted. Nachdem der Profiler von diesem Rückruf zurückgegeben wurde, sollte er alle Objekt-IDs als ungültig betrachten, bis er einen ICorProfilerCallback2::GarbageCollectionFinished-Rückruf empfängt.

Anforderungen

Plattformen: Informationen finden Sie unter Systemanforderungen.

Header: CorProf.idl, CorProf.h

Bibliothek: CorGuids.lib

.NET Framework-Versionen: Seit 2.0 verfügbar.

Siehe auch