Sdílet prostřednictvím


ICorProfilerCallback::RootReferences – metoda

Upozorní profiler s informacemi o kořenových odkazech po uvolnění paměti.

Syntaxe

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

Parametry

cRootRefs
[v] Počet odkazů v matici rootRefIds .

rootRefIds
[v] Pole ID objektů, které odkazují buď na statický objekt, nebo na objekt v zásobníku.

Poznámky

ICorProfilerCallback2::RootReferences2 jsou volány pro upozornění profileru.RootReferences Profilátory obvykle implementují jednu nebo druhou, ale ne obě, protože předávané RootReferences2 informace jsou nadmnožinou informací předaných v RootReferences.

Je možné, rootRefIds že pole obsahuje objekt null. Například všechny odkazy na objekty deklarované v zásobníku jsou nástrojem uvolňování paměti považovány za kořeny a budou vždy hlášeny.

ID objektů vrácená nástrojem RootReferences nejsou platná během samotného zpětného volání, protože uvolňování paměti může být uprostřed přesunu objektů ze starých adres na nové adresy. Proto se profilátory nesmí pokoušet kontrolovat objekty během RootReferences volání. Při volání ICorProfilerCallback2::GarbageCollectionFinished byly všechny objekty přesunuty do svých nových umístění a lze je bezpečně zkontrolovat.

Požadavky

Platformy: Viz Požadavky na systém.

Záhlaví: CorProf.idl, CorProf.h

Knihovny: CorGuids.lib

Verze rozhraní .NET Framework: K dispozici od verze 2.0

Viz také