Dela via


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

Se även