ICorProfilerCallback::RootReferences Yöntemi
Çöp toplama sonrasında kök başvurular hakkında bilgilerle profil oluşturucuya bildirir.
Sözdizimi
HRESULT RootReferences(
[in] ULONG cRootRefs,
[in, size_is(cRootRefs)] ObjectID rootRefIds[] );
Parametreler
cRootRefs
[in] Dizideki rootRefIds
başvuru sayısı.
rootRefIds
[in] Yığındaki statik bir nesneye veya nesneye başvuran nesne kimlikleri dizisi.
Açıklamalar
Profil oluşturucuyu bilgilendirmek için hem hem de RootReferences
ICorProfilerCallback2::RootReferences2 çağrılır. Profil oluşturucular normalde birini veya diğerini uygular, ancak her ikisini birden uygulamaz, çünkü geçirilen RootReferences2
bilgiler içinde RootReferences
geçirilen bir üst kümedir.
Dizinin null bir nesne içermesi mümkündür rootRefIds
. Örneğin, yığında bildirilen tüm nesne başvuruları, atık toplayıcı tarafından kök olarak değerlendirilir ve her zaman bildirilir.
tarafından RootReferences
döndürülen nesne kimlikleri, geri çağırma sırasında geçerli değildir çünkü çöp toplama, nesneleri eski adreslerden yeni adreslere taşıma işleminin ortasında olabilir. Bu nedenle, profil oluşturucular bir RootReferences
çağrı sırasında nesneleri incelemeye çalışmamalıdır. ICorProfilerCallback2::GarbageCollectionFinished çağrıldığında, tüm nesneler yeni konumlarına taşınır ve güvenli bir şekilde denetlenebilir.
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