Partager via

ICorProfilerCallback2::GarbageCollectionStarted, méthode

  • Article

Avertit le profileur de code que le garbage collection a démarré.

Syntaxe

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 booléennes, qui sont true si la génération qui correspond à l’index de 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, qui indique 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é démarré.

Notes

Tous les rappels qui se rapportent à ce garbage collection se produisent entre le rappel GarbageCollectionStarted et le rappel ICorProfilerCallback2::GarbageCollectionFinished correspondant. Ces rappels n’ont pas besoin de se produire sur le même thread.

Il est plus sûr pour le profileur d’inspecter les objets dans leurs emplacements d’origine pendant le rappel GarbageCollectionStarted. Le garbage collector commence à déplacer des objets après le retour du rappel GarbageCollectionStarted. Une fois le profileur retourné par ce rappel, le profileur doit considérer que tous les ID d’objet ne sont pas valides tant qu’il n’a pas reçu un rappel ICorProfilerCallback2::GarbageCollectionFinished.

Spécifications

Plateformes : Consultez Configuration requise.

En-tête : CorProf.idl, CorProf.h

Bibliothèque : CorGuids.lib

Versions de .NET Framework : Disponible depuis la version 2.0

Voir aussi