Bagikan melalui

Metode ICorProfilerCallback2::GarbageCollectionStarted

  • Artikel

Memberi tahu profiler kode bahwa pengumpulan sampah telah dimulai.

Sintaks

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

Parameter

cGenerations
[in] Jumlah total entri dalam array generationCollected.

generationCollected
[in] Array nilai Boolean, yaitu true jika generasi yang sesuai dengan indeks array dikumpulkan oleh pengumpulan sampah ini; jika tidak, false.

Array diindeks oleh nilai enumerasi COR_PRF_GC_GENERATION, yang menunjukkan pembuatan.

reason
[ini] Nilai enumerasi COR_PRF_GC_REASON yang menunjukkan alasan pengumpulan sampah dilakukan.

Keterangan

Semua panggilan balik yang terkait dengan pengumpulan sampah ini akan terjadi antara panggilan balik GarbageCollectionStarted dan panggilan balik ICorProfilerCallback2::GarbageCollectionFinished yang sesuai. Panggilan balik ini tidak perlu terjadi pada utas yang sama.

Aman bagi profiler untuk memeriksa objek di lokasi aslinya selama panggilan balik GarbageCollectionStarted. Pengumpul sampah akan mulai memindahkan objek setelah kembali dari GarbageCollectionStarted. Setelah profiler kembali dari panggilan balik ini, profiler harus menganggap semua ID objek tidak valid hingga menerima panggilan balik ICorProfilerCallback2::GarbageCollectionFinished.

Persyaratan

Platform: Lihat Persyaratan Sistem.

Header: CorProf.idl, CorProf.h

Pustaka: CorGuids.lib

Versi .NET Framework: Tersedia mulai dari 2.0

Lihat juga