ICorProfilerCallback2::GarbageCollectionStarted, méthodeICorProfilerCallback2::GarbageCollectionStarted Method

Notifie le profileur de code que le garbage collection a démarré.Notifies the code profiler that garbage collection has started.

SyntaxeSyntax

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

ParamètresParameters

cGenerations
[in] Le nombre total d’entrées dans le generationCollected tableau.[in] The total number of entries in the generationCollected array.

generationCollected
[in] Un tableau de valeurs booléennes, qui sont true si la génération qui correspond à l’index de tableau est collecté par ce garbage collection ; sinon, false.[in] An array of Boolean values, which are true if the generation that corresponds to the array index is being collected by this garbage collection; otherwise, false.

Le tableau est indexé par une valeur de la COR_PRF_GC_GENERATION énumération, qui indique la génération.The array is indexed by a value of the COR_PRF_GC_GENERATION enumeration, which indicates the generation.

reason
[in] Une valeur de la COR_PRF_GC_REASON énumération qui indique la raison pour laquelle le garbage collection a été INDUITE.[in] A value of the COR_PRF_GC_REASON enumeration that indicates the reason the garbage collection was induced.

NotesRemarks

Tous les rappels qui se rapportent à ce garbage collection seront produit entre le GarbageCollectionStarted rappel et le correspondantes ICorProfilerCallback2::GarbageCollectionFinished rappel.All callbacks that pertain to this garbage collection will occur between the GarbageCollectionStarted callback and the corresponding ICorProfilerCallback2::GarbageCollectionFinished callback. Ces rappels ne doivent pas se produire sur le même thread.These callbacks need not occur on the same thread.

Il est possible que le profileur inspecter les objets dans leurs emplacements d’origine pendant le GarbageCollectionStarted rappel.It is safe for the profiler to inspect objects in their original locations during the GarbageCollectionStarted callback. Le garbage collector commencera à déplacer les objets après le retour de GarbageCollectionStarted.The garbage collector will begin moving objects after the return from GarbageCollectionStarted. Une fois que le profileur a retourné à partir de ce rappel, le profileur doit considérer tous les ID d’objet est non valide jusqu'à ce qu’il reçoive un ICorProfilerCallback2::GarbageCollectionFinished rappel.After the profiler has returned from this callback, the profiler should consider all object IDs to be invalid until it receives a ICorProfilerCallback2::GarbageCollectionFinished callback.

Configuration requiseRequirements

Plateformes : Consultez Configuration requise.Platforms: See System Requirements.

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

Bibliothèque : CorGuids.libLibrary: CorGuids.lib

Versions du .NET Framework : Disponible à partir de 2.0Available since 2.0.NET Framework Versions: Disponible à partir de 2.0Available since 2.0

Voir aussiSee also