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
