Share via

Metodo ICorProfilerCallback2::GarbageCollectionStarted

  • Articolo

Notifica al profiler di codice che è stata avviata l'operazione di Garbage Collection.

Sintassi

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

Parametri

cGenerations
[in] Numero totale di voci nella generationCollected matrice.

generationCollected
[in] Matrice di valori booleani, che sono true se la generazione che corrisponde all'indice della matrice viene raccolta da questa Operazione di Garbage Collection; in caso contrario, false.

La matrice viene indicizzata da un valore dell'enumerazione COR_PRF_GC_GENERATION , che indica la generazione.

reason
[in] Valore dell'enumerazione COR_PRF_GC_REASON che indica il motivo per cui è stata indotta l'operazione di Garbage Collection.

Commenti

Tutti i callback relativi a questa Operazione di Garbage Collection verranno eseguiti tra il GarbageCollectionStarted callback e il callback ICorProfilerCallback2::GarbageCollectionFinished . Questi callback non devono verificarsi nello stesso thread.

È sicuro che il profiler controlli gli oggetti nelle posizioni originali durante il GarbageCollectionStarted callback. Il Garbage Collector inizierà a spostare gli oggetti dopo il ritorno da GarbageCollectionStarted. Dopo che il profiler è stato restituito da questo callback, il profiler deve considerare tutti gli ID oggetto non validi fino a quando non riceve un ICorProfilerCallback2::GarbageCollectionFinished callback.

Requisiti

Piattaforme: vedere Requisiti di sistema di .NET Framework.

Intestazione: CorProf.idl, CorProf.h

Libreria: CorGuids.lib

Versioni di .NET Framework: Disponibile dalla versione 2.0

Vedi anche