Metodo ICorProfilerCallback2::GarbageCollectionStarted

Articolo
08/11/2011

Notifica al Code Profiler che è iniziata la Garbage Collection.

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 matrice generationCollected.
generationCollected
[in] Matrice di valori booleani che sono true se la generazione che corrisponde all'indice della matrice viene raccolta da Garbage Collection; in caso contrario, false.

La matrice è indicizzata in base a 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 è stato eseguito Garbage Collection.

Note

Tutti i callback relativi a tale Garbage Collection si verificheranno tra il callback di GarbageCollectionStarted e il callback di ICorProfilerCallback2::GarbageCollectionFinished corrispondente. Questi callback non devono necessariamente verificarsi sullo stesso thread.

Non vi sono rischi se il profiler controlla gli oggetti nei relativi percorsi originali durante il callback di GarbageCollectionStarted. Il Garbage Collector inizierà a spostare gli oggetti dopo l'uscita da GarbageCollectionStarted. Dopo essere uscito da questo callback, il profiler deve considerare non validi tutti gli ID oggetto finché non riceve un callback di ICorProfilerCallback2::GarbageCollectionFinished.