GrupoDeRelogaçãodinâmica

O C++ Build Insights SDK é compatível com o Visual Studio 2017 e posterior. Para ver a documentação destas versões, defina o controlo seletor de versão do Visual Studio para este artigo para Visual Studio 2017 ou posterior. Encontra-se na parte superior do índice desta página.

A função MakeDynamicReloggerGroup é usada para criar um grupo dinâmico de relogger. Os membros de um grupo de relogger recebem eventos um a um, da esquerda para a direita, até que todos os eventos em um rastreamento tenham sido processados.

Sintaxe

auto MakeDynamicReloggerGroup(std::vector<IRelogger*> reloggers);

auto MakeDynamicReloggerGroup(std::vector<std::shared_ptr<IRelogger>> reloggers);

auto MakeDynamicReloggerGroup(std::vector<std::unique_ptr<IRelogger>> reloggers);

Parâmetros

reloggers
Um vetor de ponteiros IRelogger incluídos no grupo dinâmico de relogger. Esses ponteiros podem ser brutos, std::unique_ptrou std::shared_ptr. Os ponteiros IAnalyzer também são considerados IRelogger ponteiros devido a uma relação de herança.

Valor de retorno

Um grupo de relogger dinâmico. Use a auto palavra-chave para capturar o valor de retorno.

Observações

Ao contrário dos grupos de relogger estáticos, os membros de um grupo de relogger dinâmico não precisam ser conhecidos em tempo de compilação. Você pode escolher membros do grupo relogger em tempo de execução com base na entrada do programa ou com base em outros valores que são desconhecidos em tempo de compilação. Ao contrário dos grupos estáticos de relogger, os ponteiros dentro de um grupo dinâmico de relogger têm um comportamento polimórfico e as chamadas de funções virtuais são efetuadas corretamente. Essa flexibilidade tem o custo de um tempo de processamento de eventos possivelmente mais lento. Quando todos os membros do grupo de relogger são conhecidos no momento da compilação, e se não for necessário comportamento polimórfico, considere usar um grupo de relogger estático. Para usar um grupo de relogger estático, chame MakeStaticReloggerGroup em vez disso.

Um grupo de relogger dinâmico pode ser encapsulado dentro de um grupo de relogger estático. Passa o endereço para MakeStaticReloggerGroup. Utilize esta técnica para passar grupos de reloggers dinâmicos para funções como Relog, que só aceitam grupos de reloggers estáticos.