Поделиться через

StopAndAnalyzeTracingSession

  • Статья

Пакет SDK для Сборки C++ совместим с Visual Studio 2017 и более поздними версиями. Чтобы увидеть документацию для этих версий, установите в данной статье селектор Версия Visual Studio в Visual Studio 2017 и более поздних версий. Он находится в верхней части оглавления на этой странице.

Функция StopAndAnalyzeTracingSession останавливает текущий сеанс трассировки и сохраняет итоговую трассировку во временном файле. Затем сразу же запускается сеанс анализа с использованием временного файла в качестве входных данных. Исполняемые файлы, вызывающие эту функцию, должны иметь привилегии администратора.

Синтаксис

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

Параметры

sessionName
Имя останавливаемого сеанса трассировки. Используйте то же имя сеанса, которое было передано в StartTracingSession, StartTracingSessionA или StartTracingSessionW.

numberOfAnalysisPasses
Количество проходов анализа, которые необходимо выполнить во время трассировки. Трассировка передается через предоставленную группу анализатора один раз для каждого выполнения анализа.

statistics
Указатель на объект TRACING_SESSION_STATISTICS. StopAndAnalyzeTracingSession записывает статистику сбора трассировки в этот объект перед возвратом.

analyzerGroup
Группа анализатора, используемая для анализа. Вызовите MakeStaticAnalyzerGroup, чтобы создать группу анализатора. Чтобы использовать динамическую группу анализаторов, полученную из MakeDynamicAnalyzerGroup, сначала инкапсулируйте ее в статической группе анализаторов, передав ее адрес в MakeStaticAnalyzerGroup.

Возвращаемое значение

Код результата из перечисления RESULT_CODE.