Udostępnij za pośrednictwem

ICorProfilerCallback2::GarbageCollectionStarted — Metoda

  • Artykuł

Powiadamia profilera kodu, że rozpoczęto odzyskiwanie pamięci.

Składnia

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

Parametry

cGenerations
[in] Całkowita liczba wpisów w tablicy generationCollected .

generationCollected
[in] Tablica wartości logicznych, które są true , jeśli generacja odpowiadająca indeksowi tablicy jest zbierana przez to odzyskiwanie pamięci; w przeciwnym razie false.

Tablica jest indeksowana przez wartość wyliczenia COR_PRF_GC_GENERATION , która wskazuje generację.

reason
[in] Wartość wyliczenia COR_PRF_GC_REASON wskazująca przyczynę wywołania odzyskiwania pamięci.

Uwagi

Wszystkie wywołania zwrotne odnoszące się do tego odzyskiwania pamięci wystąpią między GarbageCollectionStarted wywołaniem zwrotnym a odpowiadającym wywołaniem zwrotnym ICorProfilerCallback2::GarbageCollectionFinished wywołania zwrotnego . Te wywołania zwrotne nie muszą występować w tym samym wątku.

Profiler może bezpiecznie sprawdzać obiekty w oryginalnych lokalizacjach podczas wywołania zwrotnego GarbageCollectionStarted . Moduł odśmiecający śmieci rozpocznie przenoszenie obiektów po powrocie z GarbageCollectionStarted. Po powrocie profilera z tego wywołania zwrotnego profiler powinien rozważyć, że wszystkie identyfikatory obiektów będą nieprawidłowe, dopóki nie otrzyma wywołania zwrotnego ICorProfilerCallback2::GarbageCollectionFinished .

Wymagania

Platformy: Zobacz Wymagania systemowe.

Nagłówka: CorProf.idl, CorProf.h

Biblioteki: CorGuids.lib

wersje .NET Framework: dostępne od wersji 2.0

Zobacz też