Metode ICorProfilerCallback::RootReferences

Memberi tahu profiler dengan informasi tentang referensi root setelah pengumpulan sampah.

Sintaks

HRESULT RootReferences(  
    [in] ULONG    cRootRefs,  
    [in, size_is(cRootRefs)] ObjectID rootRefIds[] );  

Parameter

cRootRefs
[in] Jumlah referensi dalam array rootRefIds.

rootRefIds
[in] Array ID objek yang mereferensikan objek statis atau objek pada tumpukan.

Keterangan

Baik RootReferences dan ICorProfilerCallback2::RootReferences2 dipanggil untuk memberi tahu profiler. Profiler biasanya akan mengimplementasikan satu atau yang lain, tetapi tidak keduanya, karena informasi yang diteruskan RootReferences2 adalah superset dari yang diteruskan di RootReferences.

Memungkinkan bagi array rootRefIds untuk berisi objek null. Misalnya, semua referensi objek yang dinyatakan pada tumpukan diperlakukan sebagai akar oleh pengumpul sampah dan akan selalu dilaporkan.

ID objek yang dikembalikan oleh RootReferences tidak valid selama panggilan balik itu sendiri, karena pengumpulan sampah mungkin berada di tengah-tengah objek yang bergerak. Oleh karena itu, profiler tidak boleh mencoba memeriksa objek selama panggilan RootReferences. Ketika ICorProfilerCallback2::GarbageCollectionFinished dipanggil, semua objek telah dipindahkan ke lokasi baru mereka dan dapat diperiksa dengan aman.

Persyaratan

Platform: Lihat Persyaratan Sistem.

Header: CorProf.idl, CorProf.h

Pustaka: CorGuids.lib

Versi .NET Framework: Tersedia mulai dari 2.0

Lihat juga

• Antarmuka ICorProfilerCallback