ICorProfilerCallback2::GarbageCollectionStarted Yöntemi

Kod profil oluşturucusunun çöp toplama işleminin başlatıldığını bildirir.

Sözdizimi

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

Parametreler

cGenerations
[in] Dizideki generationCollected toplam girdi sayısı.

generationCollected
[in] Dizi dizinine karşılık gelen oluşturma bu çöp toplama tarafından toplanıyorsa boole değerleri true dizisi; aksi takdirde, false.

Dizi, oluşturma işlemini gösteren COR_PRF_GC_GENERATION sabit listesinin bir değeriyle dizine eklenir.

reason
[in] Çöp toplamanın neden oluşturulduğuna işaret eden COR_PRF_GC_REASON sabit listesi değeri.

Açıklamalar

Bu çöp toplamayla ilgili tüm geri çağırmalar, geri çağırma ile karşılık gelen ICorProfilerCallback2::GarbageCollectionFinished geri çağırması arasında GarbageCollectionStarted gerçekleşir. Bu geri çağırmalar aynı iş parçacığında gerçekleşmez.

Profil oluşturucunun geri arama sırasında GarbageCollectionStarted özgün konumlarındaki nesneleri incelemesi güvenlidir. Atık toplayıcı, nesnesinden GarbageCollectionStarteddöndükten sonra nesneleri taşımaya başlar. Profil oluşturucu bu geri çağırmadan döndürdükten sonra, profil oluşturucu bir geri çağırma alana kadar tüm nesne kimliklerini ICorProfilerCallback2::GarbageCollectionFinished geçersiz olarak düşünmelidir.

Gereksinimler

Platform: Bkz. Sistem Gereksinimleri.

Üstbilgi: CorProf.idl, CorProf.h

Kitaplığı: CorGuids.lib

.NET Framework Sürümleri: 2.0 sürümünden itibaren kullanılabilir

Ayrıca bkz.

• ICorProfilerCallback Arabirimi
• ICorProfilerCallback2 Arabirimi