ICorProfilerCallback5::Método ConditionalWeakTableElementReferences

Identifica o fechamento transitivo de objetos referenciados por estas raízes por meio de referências diretas do campo de membro e de dependências ConditionalWeakTable.

Sintaxe

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

Parâmetros

cRootRefs
[in] O número de elementos nas matrizes keyRefIds, valueRefIds e rootIds.

keyRefIds
[in] Uma matriz de IDs de objeto, cada uma contendo o ObjectID para o elemento principal do par do identificador dependente.

valueRefIds
[in] Uma matriz de IDs de objeto, cada uma contendo o ObjectID para o elemento secundário do par do identificador dependente. (keyRefIds[i] mantém valueRefIds[i] vivo.)

rootIds
[in] Uma matriz de valores GCHandleID que apontam para um número inteiro que contém informações adicionais sobre a raiz de coleta de lixo.

Nenhum dos valores ObjectID retornados pelo método ConditionalWeakTableElementReferences é válido durante o retorno de chamada em si, porque o coletor de lixo pode estar no processo de mover objetos de locais antigos para novos. Portanto, os criadores de perfis não devem tentar inspecionar objetos durante uma chamada ConditionalWeakTableElementReferences. Ao GarbageCollectionFinished, todos os objetos foram movidos para os novos locais e a inspeção pode ser feita.

Exemplo

O exemplo de código a seguir demonstra como implementar o ICorProfilerCallback5 e usar esse método.

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;
}

Comentários

Um criador de perfil para o .NET Framework 4.5 ou versões posteriores implementa a interface ICorProfilerCallback5 e registra as dependências especificadas pelo método ConditionalWeakTableElementReferences. ICorProfilerCallback5 fornece o conjunto completo de dependências entre os objetos ativos representados pelas entradas de ConditionalWeakTable. Essas dependências e as referências de campo de membro especificadas pelo método ICorProfilerCallback::ObjectReferences permitem que um criador de perfil gere o grafo de objeto completo de objetos vivos.

Requisitos

Plataformas: confira Requisitos do sistema.

Cabeçalho: CorProf.idl, CorProf.h

Versões do .NET Framework: Disponíveis desde a versão 4.5

Confira também

• Interface ICorProfilerCallback5