StartTracingSession2

O C++ Build Insights SDK funciona com o Visual Studio 2017 e versões posteriores. 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.

A StartTracingSession2 função C++ inicia uma sessão de rastreamento com propriedades de ativação configuráveis do Event Tracing for Windows (ETW). Requer a versão 1.6.0 ou posterior do Microsoft.Cpp.BuildInsights pacote NuGet. Os executáveis que chamam esta 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 quando chamar StopTracingSession ou outra função de parar.

options
Uma referência a um objeto de estrutura TRACING_SESSION_OPTIONS_V2. Utilize-o para selecionar eventos e definir flags de enable-property para o fornecedor MSVC.

Valor de retorno

Um código de resultado do RESULT_CODE enum enum.

Example

A função seguinte inicia um rastreamento de host que pode recolher eventos MSVC a partir de contentores Windows isolados ao nível do processo. Utilize um SDK do Windows que defina 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 a compilação. Quando a compilação terminar, pare o rastreio usando o mesmo nome de sessão. Estes campos de seleção de eventos inicializados a zero recolhem os eventos MSVC necessários sem iniciar um rastreio de sistema separado. Para selecionar mais eventos MSVC ou de sistema, defina os campos correspondentes em options.

Ver também