ICorProfilerCallback2::GarbageCollectionStarted, méthode

Article
08/10/2011

Notifie au profileur de code qu'un garbage collection a démarré.

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

Paramètres

cGenerations
[in] Nombre total d'entrées dans le tableau generationCollected.
generationCollected
[in] Tableau de valeurs Boolean qui sont true si la génération correspondant à l'index du tableau est collectée par ce garbage collection ; sinon, false.

Le tableau est indexé par une valeur de l'énumération COR_PRF_GC_GENERATION, indiquant la génération.
reason
[in] Valeur de l'énumération COR_PRF_GC_REASON qui indique la raison pour laquelle le garbage collection a été induit.

Notes

Tous les rappels relatifs à ce garbage collection se produiront entre le rappel GarbageCollectionStarted et le rappel ICorProfilerCallback2::GarbageCollectionFinished correspondant. Ces rappels n'ont pas besoin d'avoir lieu sur le même thread.

Le profileur peut inspecter sans risque les objets dans leurs emplacements d'origine pendant le rappel GarbageCollectionStarted. Le garbage collector commencera à déplacer les objets après le retour de GarbageCollectionStarted. Après le retour de ce rappel, le profileur doit considérer tous les ID d'objet comme non valides jusqu'à ce qu'il reçoive un rappel ICorProfilerCallback2::GarbageCollectionFinished.