ICorProfilerCallback::RootReferences, metod
Meddelar profileraren med information om rotreferenser efter skräpinsamling.
Syntax
HRESULT RootReferences(
[in] ULONG cRootRefs,
[in, size_is(cRootRefs)] ObjectID rootRefIds[] );
Parametrar
cRootRefs
[in] Antalet referenser i matrisen rootRefIds
.
rootRefIds
[in] En matris med objekt-ID:t som refererar till antingen ett statiskt objekt eller ett objekt i stacken.
Kommentarer
Både RootReferences
och ICorProfilerCallback2::RootReferences2 anropas för att meddela profileraren. Profilerare implementerar normalt det ena eller det andra, men inte båda, eftersom informationen som skickas är RootReferences2
en supermängd av som skickas i RootReferences
.
Matrisen rootRefIds
kan innehålla ett null-objekt. Till exempel behandlas alla objektreferenser som deklareras i stacken som rötter av skräpinsamlaren och rapporteras alltid.
Objekt-ID:n som returneras av RootReferences
är inte giltiga under själva återanropet, eftersom skräpinsamlingen kan vara mitt i att flytta objekt från gamla adresser till nya adresser. Profilerare får därför inte försöka inspektera objekt under ett RootReferences
anrop. När ICorProfilerCallback2::GarbageCollectionFinished anropas har alla objekt flyttats till sina nya platser och kan inspekteras på ett säkert sätt.
Krav
Plattformar: Se Systemkrav.
Huvudet: CorProf.idl, CorProf.h
Bibliotek: CorGuids.lib
.NET Framework versioner: Tillgänglig sedan 2.0