Compartir vía

StopAndAnalyzeTracingSession

  • Artículo

El SDK de C++ Build Insights es compatible 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. Se encuentra en la parte superior de la tabla de contenido de esta página.

La función StopAndAnalyzeTracingSession detiene una sesión de seguimiento en curso y guarda el seguimiento resultante en un archivo temporal. Se inicia de inmediato una sesión de análisis con el archivo temporal como entrada. Los ejecutables que llaman a esta función deben tener privilegios de administrador.

Sintaxis

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);

Parámetros

sessionName
Nombre de la sesión de seguimiento que se va a detener. Use el mismo nombre de sesión que se pasó a StartTracingSession, StartTracingSessionA o StartTracingSessionW.

numberOfAnalysisPasses
Número de pasos de análisis que se van a ejecutar en el seguimiento. El seguimiento se pasa una vez a través del grupo de analizadores proporcionado por cada paso de análisis.

estadísticas
Puntero a un objeto TRACING_SESSION_STATISTICS. StopAndAnalyzeTracingSession escribe estadísticas de la colección de seguimientos en este objeto antes de devolver un valor.

analyzerGroup
El grupo de analizadores que se usa para el análisis. Llame a MakeStaticAnalyzerGroup para crear un grupo de analizadores. Si quiere usar un grupo de analizadores dinámico obtenido de MakeDynamicAnalyzerGroup, primero debe pasar su dirección a MakeStaticAnalyzerGroup para encapsularlo dentro de un grupo de analizadores estático.

Valor devuelto

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