다음을 통해 공유

StopAndAnalyzeTracingSession

  • 아티클

C++ Build Insights SDK는 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에 전달하여 정적 분석기 그룹 안에서 캡슐화해야 합니다.

Return Value

RESULT_CODE 열거형의 결과 코드입니다.