StartTracingSession2

El SDK de C++ Build Insights funciona con Visual Studio 2017 y versiones posteriores. Para ver la documentación de estas versiones, establezca el control de selector de Versión de Visual Studio para este artículo en Visual Studio 2017 o versiones posteriores.

La función StartTracingSession2 de C++ inicia una sesión de seguimiento con propiedades de habilitación configurables de Event Tracing for Windows (ETW). Requiere la versión 1.6.0 o posterior del Microsoft.Cpp.BuildInsights paquete NuGet. Los ejecutables que llaman a esta función deben tener privilegios de administrador.

Syntax

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
Nombre de la sesión de seguimiento que debe iniciarse. Utilice el mismo nombre al llamar a StopTracingSession u otra función de detención.

opciones
Referencia a un objeto de la estructura TRACING_SESSION_OPTIONS_V2. Úselo para seleccionar eventos y establecer indicadores enable-property para el proveedor MSVC.

Valor de retorno

Código de resultado de la enumeración RESULT_CODE enum.

Example

La función siguiente inicia un seguimiento de host que puede recopilar eventos de MSVC de contenedores de Windows con aislamiento de proceso. Use un SDK de Windows que defina EVENT_ENABLE_PROPERTY_ENABLE_SILOS en <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);
}

Compruebe el resultado antes de ejecutar la compilación. Cuando finalice la compilación, detenga el seguimiento con el mismo nombre de sesión. Estos campos de selección de eventos inicializados a cero recopilan los eventos DE MSVC necesarios sin iniciar un seguimiento del sistema independiente. Para seleccionar más eventos del sistema o MSVC, establezca los campos correspondientes en options.

Consulte también