Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
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.