StartTracingSession2

O SDK do C++ Build Insights funciona com Visual Studio 2017 e posteriores. Para ver a documentação dessas versões, defina o controle seletor de versão do Visual Studio deste artigo para Visual Studio 2017 ou posterior.

A StartTracingSession2 função C++ inicia uma sessão de rastreamento com propriedades de habilitação configuráveis do Event Tracing for Windows (ETW). Ele requer a versão 1.6.0 ou posterior do pacote Microsoft.Cpp.BuildInsights NuGet. Os executáveis que chamam essa função devem ter privilégios de administrador.

Sintaxe

RESULT_CODE StartTracingSession2(
    const char*                       sessionName,
    const TRACING_SESSION_OPTIONS_V2& options);

RESULT_CODE StartTracingSession2(
    const wchar_t*                    sessionName,
    const TRACING_SESSION_OPTIONS_V2& options);

Parameters

sessionName
O nome da sessão de rastreamento a ser iniciada. Use o mesmo nome ao chamar StopTracingSession ou outra função de parada.

opções
Uma referência a um objeto da estrutura TRACING_SESSION_OPTIONS_V2. Use isso para selecionar eventos e definir sinalizadores de propriedade de habilitação para o provedor MSVC.

Valor de devolução

Um código de resultado da enumeração RESULT_CODE.

Example

A função a seguir inicia um rastreamento de host que pode coletar eventos MSVC de contêineres do Windows com isolamento por processo. Use um SDK do Windows que define EVENT_ENABLE_PROPERTY_ENABLE_SILOS em <evntcons.h>.

#include <Windows.h>
#include <evntcons.h>
#include <CppBuildInsights.hpp>

using namespace Microsoft::Cpp::BuildInsights;

RESULT_CODE StartContainerBuildTrace()
{
    TRACING_SESSION_OPTIONS_V2 options{};
    options.EnablePropertyFlags = EVENT_ENABLE_PROPERTY_ENABLE_SILOS;

    return StartTracingSession2(L"ContainerBuild", options);
}

Verifique o resultado antes de executar o build. Quando o build for concluído, interrompa o rastreamento usando o mesmo nome de sessão. Esses campos de seleção de eventos inicializados com zero coletam os eventos MSVC necessários sem iniciar um rastreamento de sistema separado. Para selecionar mais eventos do MSVC ou do sistema, defina os campos correspondentes em options.

Consulte também