Metoda ICorProfilerCallback5::ConditionalWeakTableElementReferences

Identyfikuje przechodnie zamknięcie obiektów, do których odwołuje się te korzenie, za pośrednictwem odwołań do pól składowych bezpośrednich i zależności ConditionalWeakTable .

Składnia

HRESULT ConditionalWeakTableElementReferences(
     [in]                     ULONG    cRootRefs,
     [in, size_is(cRootRefs)] ObjectID keyRefIds[],
     [in, size_is(cRootRefs)] ObjectID valueRefIds[],
     [in, size_is(cRootRefs)] GCHandleID rootIds[]
);

Parametry

cRootRefs
[w] Liczba elementów w keyRefIdstablicach , valueRefIdsi rootIds .

keyRefIds
[w] Tablica identyfikatorów obiektów, z których każda zawiera ObjectID element podstawowy w zależnej parze uchwytów.

valueRefIds
[w] Tablica identyfikatorów obiektów, z których każda zawiera ObjectID element pomocniczy w zależnej parze uchwytów. (keyRefIds[i] utrzymuje valueRefIds[i] przy życiu).

rootIds
[w] Tablica wartości wskazująca GCHandleID liczbę całkowitą zawierającą dodatkowe informacje o katalogu głównym odzyskiwania pamięci.

Żadna z ObjectID wartości zwróconych przez metodę ConditionalWeakTableElementReferences nie jest prawidłowa podczas samego wywołania zwrotnego, ponieważ moduł odśmiecający pamięci może być w trakcie przenoszenia obiektów ze starych do nowych lokalizacji. W związku z tym profilerzy nie powinni próbować sprawdzać obiektów podczas wywołania ConditionalWeakTableElementReferences . W GarbageCollectionFinishedsystemie wszystkie obiekty zostały przeniesione do nowych lokalizacji i można przeprowadzić inspekcję.

Przykład

W poniższym przykładzie kodu pokazano, jak zaimplementować metodę ICorProfilerCallback5 i użyć tej metody.

HRESULT Callback5Impl::ConditionalWeakTableElementReferences(
    ULONG      cRootRefs,
    ObjectID   keyRefIds[],
    ObjectID   valueRefIds[],
    GCHandleID rootIds[])
{
    printf("Callback5Impl::ConditionalWeakTableElementReferences called\n");
    for (unsigned int i = 0; i < cRootRefs; ++i)
    {
        // Save dependency to XML for later retrieval
        PersistDependencyToXml(rootIds[i], keyRefIds[i], valueRefIds[i]);
        // or store dependency to an internal map
        m_cwt_deps->add_dep(rootIds[i], keyRefIds[i], valueRefIds[i]);
        // or add arc to object graph
        m_obj_graph->add_arc(keyRefIds[i], valueRefIds[i], rootIds[i]);
    }
    return S_OK;
}

Uwagi

Profiler dla wersji .NET Framework 4.5 lub nowszej implementuje interfejs ICorProfilerCallback5 i rejestruje zależności określone przez metodęConditionalWeakTableElementReferences. ICorProfilerCallback5 zapewnia pełny zestaw zależności między obiektami na żywo reprezentowanymi przez ConditionalWeakTable wpisy. Te zależności i odwołania do pól składowych określone przez metodę ICorProfilerCallback::ObjectReferences umożliwiają profilerowi zarządzanemu generowanie pełnego grafu obiektów na żywo.

Wymagania

Platformy: Zobacz Wymagania systemowe.

Nagłówka: CorProf.idl, CorProf.h

.NET Framework wersje: dostępne od wersji 4.5

Zobacz też

• ICorProfilerCallback5 — Interfejs