Partager via

StopAndAnalyzeTracingSession

  • Article

Le SDK Build Insights C++ est compatible avec Visual Studio 2017 et ultérieur. Pour consulter la documentation de ces versions, définissez le contrôle de sélecteur Version de Visual Studio pour cet article sur Visual Studio 2017 ou ultérieur. Il se trouve en haut de la table des matières de cette page.

La StopAndAnalyzeTracingSession fonction arrête une session de suivi en cours et enregistre la trace résultante dans un fichier temporaire. Une session d’analyse est ensuite immédiatement démarrée à l’aide du fichier temporaire en tant qu’entrée. Les exécutables appelant cette fonction doivent disposer de privilèges d’administrateur.

Syntaxe

template <typename... TAnalyzerGroupMembers>
RESULT_CODE StopAndAnalyzeTracingSession(
    const char*                                   sessionName,
    unsigned                                      numberOfAnalysisPasses,
    TRACING_SESSION_STATISTICS*                   statistics,
    StaticAnalyzerGroup<TAnalyzerGroupMembers...> analyzerGroup);

template <typename... TAnalyzerGroupMembers>
RESULT_CODE StopAndAnalyzeTracingSession(
    const wchar_t*                                sessionName,
    unsigned                                      numberOfAnalysisPasses,
    TRACING_SESSION_STATISTICS*                   statistics,
    StaticAnalyzerGroup<TAnalyzerGroupMembers...> analyzerGroup);

Paramètres

sessionName
Nom de la session de suivi à arrêter. Utilisez le même nom de session que celui passé à StartTracingSession, StartTracingSessionA ou StartTracingSessionW.

numberOfAnalysisPasses
Le nombre d’analyses passe à exécuter sur la trace. La trace est transmise par le groupe d’analyseurs fourni une fois par passe d’analyse.

statistiques
Pointeur vers un objet TRACING_SESSION_STATISTICS . StopAndAnalyzeTracingSession écrit les statistiques de collection de traces dans cet objet avant de retourner.

analyzerGroup
Groupe d’analyseurs utilisé pour l’analyse. Appelez MakeStaticAnalyzerGroup pour créer un groupe d’analyseurs. Si vous souhaitez utiliser un groupe d’analyseurs dynamiques obtenu à partir de MakeDynamicAnalyzerGroup, commencez par l’encapsuler dans un groupe d’analyseurs statiques en passant son adresse à MakeStaticAnalyzerGroup.

Valeur de retour

Code de résultat de l’énumération RESULT_CODE .