StartTracingSession2

Zestaw SDK usługi Build Insights języka C++ współpracuje z Visual Studio 2017 i nowszymi wersjami. Aby zapoznać się z dokumentacją dla tych wersji, ustaw kontrolkę selektora wersji programu Visual Studio dla tego artykułu na program Visual Studio 2017 lub nowszy.

Funkcja StartTracingSession2 języka C++ uruchamia sesję śledzenia z konfigurowalnymi właściwościami włączania funkcji Event Tracing for Windows (ETW). Wymaga wersji 1.6.0 lub nowszej Microsoft.Cpp.BuildInsights pakietu NuGet. Pliki wykonywalne wywołujące tę funkcję muszą mieć uprawnienia administratora.

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
Nazwa sesji śledzenia do uruchomienia. Użyj tej samej nazwy podczas wywoływania metody StopTracingSession lub innej funkcji zatrzymującej.

opcje
Odwołanie do struktury TRACING_SESSION_OPTIONS_V2. Służy do wybierania zdarzeń i ustawiania flag właściwości enable-property dla dostawcy MSVC.

Wartość zwracana

Kod wyniku z wyliczenia RESULT_CODE .

Example

Poniższa funkcja uruchamia ślad hosta, który może zbierać zdarzenia MSVC z kontenerów Windows z izolacją procesów. Użyj zestawu SDK Windows, który definiuje EVENT_ENABLE_PROPERTY_ENABLE_SILOS element w pliku <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);
}

Przed uruchomieniem kompilacji sprawdź wynik. Po zakończeniu kompilacji zatrzymaj śledzenie przy użyciu tej samej nazwy sesji. Te wyzerowane pola wyboru zdarzeń zbierają wymagane zdarzenia MSVC bez uruchamiania oddzielnego śledzenia systemu. Aby wybrać więcej zdarzeń MSVC lub systemowych, ustaw odpowiednie pola w options.

Informacje dodatkowe