StopAndRelogTracingSession

StopAndRelogTracingSession 함수는 진행 중인 추적 세션을 중지하고 결과 추적을 임시 파일에 저장합니다. 그러면 다시 로깅 세션이 임시 파일을 입력으로 사용하여 즉시 시작됩니다. 다시 로깅 세션에 의해 생성된 다시 로깅된 최종 추적은 호출자가 지정한 파일에 저장됩니다. 이 함수를 호출하는 실행 파일에는 관리자 권한이 있어야 합니다.

구문

template <
    typename... TAnalyzerGroupMembers,
    typename... TReloggerGroupMembers>
RESULT_CODE StopAndRelogTracingSession(
    const char*                                   sessionName,
    const char*                                   outputLogFile,
    TRACING_SESSION_STATISTICS*                   statistics,
    unsigned                                      numberOfAnalysisPasses,
    unsigned long long                            systemEventsRetentionFlags,
    StaticAnalyzerGroup<TAnalyzerGroupMembers...> analyzerGroup,
    StaticReloggerGroup<TReloggerGroupMembers...> reloggerGroup);

template <
    typename... TAnalyzerGroupMembers,
    typename... TReloggerGroupMembers>
RESULT_CODE StopAndRelogTracingSession(
    const wchar_t*                                sessionName,
    const wchar_t*                                outputLogFile,
    TRACING_SESSION_STATISTICS*                   statistics,
    unsigned                                      numberOfAnalysisPasses,
    unsigned long long                            systemEventsRetentionFlags,
    StaticAnalyzerGroup<TAnalyzerGroupMembers...> analyzerGroup,
    StaticReloggerGroup<TReloggerGroupMembers...> reloggerGroup);

매개 변수

sessionName
중지할 추적 세션의 이름입니다. StartTracingSession, StartTracingSessionA 또는 StartTracingSessionW에 전달된 것과 동일한 세션 이름을 사용해야 합니다.

outputLogFile
다시 로깅 세션에서 생성한 다시 로깅된 추적을 쓸 파일입니다.

statistics
TRACING_SESSION_STATISTICS 개체에 대한 포인터입니다. StopAndRelogTracingSession는 반환하기 전에 이 개체에 추적 컬렉션 통계를 씁니다.

numberOfAnalysisPasses
추적에서 실행할 분석 패스의 수입니다. 추적은 제공된 분석기 그룹을 통해 분석 패스별로 한 번씩 전달됩니다.

systemEventsRetentionFlags
다시 로그된 추적에 유지할 시스템 ETW 이벤트를 지정하는 RELOG_RETENTION_SYSTEM_EVENT_FLAGS 비트 마스크입니다.

analyzerGroup
다시 로깅 세션의 분석 단계에 사용하는 분석기 그룹입니다. MakeStaticAnalyzerGroup을 호출하여 분석기 그룹을 만듭니다. MakeDynamicAnalyzerGroup에서 얻은 동적 분석기 그룹을 사용하려면 먼저 해당 주소를 MakeStaticAnalyzerGroup에 전달하여 정적 분석기 그룹 안에서 캡슐화해야 합니다.

reloggerGroup
outputLogFile에서 지정된 추적 파일에 이벤트를 다시 로깅하는 재로거 그룹입니다. MakeStaticReloggerGroup을 호출하여 재로거 그룹을 만드세요. MakeDynamicReloggerGroup에서 얻은 동적 재로거 그룹을 사용하려면 먼저 해당 주소를 MakeStaticReloggerGroup에 전달하여 정적 재로거 그룹 안에서 캡슐화해야 합니다.

Return Value

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

설명

입력 추적은 분석기 그룹에 numberOfAnalysisPasses회 전달됩니다. 다시 로깅 패스에는 유사한 옵션이 없습니다. 추적은 모든 분석 패스가 완료된 후 재로거 그룹에 한 번만 전달됩니다.

재로거 클래스 내에서 CPU 샘플과 같은 시스템 이벤트의 다시 로깅은 지원되지 않습니다. systemEventsRetentionFlags 매개 변수를 사용하여 출력 추적에 유지할 시스템 이벤트를 결정합니다.