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 RootReferencesICorProfilerCallback2::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 RootReferencesgeç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

Ayrıca bkz.