추적 메시지 접두사

Tracefmt는 이벤트 추적 로그(.etl) 파일 및 추적 메시지 형식(.tmf) 파일에 저장된 데이터로 구성된 각 추적 메시지에 접두사를 추가합니다.

Tracefmt에는 기본적으로 특정 데이터 요소가 포함되지만 사용자는 FormatMessage와 호환되는 메시지 정의를 지정하는 문자열인 %TRACE_FORMAT_PREFIX% 환경 변수를 변경하여 요소를 추가하고 제거할 수 있습니다.

기본 추적 메시지 접두사 형식은 다음과 같습니다.

[%9!d!]%8!04X!.%3!04X!::%4!s! [%1!s!]

다음과 같은 접두사를 생성합니다.

[CPUNumber]ProcessID.ThreadID :: SystemTime [MessageGUIDFriendlyName]

각 %n 변수는 다음 표에 설명된 매개 변수를 나타냅니다.

접두사 변수 식별자	변수 유형	Description
%1	문자열	추적 메시지의 메시지 GUID 이름입니다. 기본적으로 메시지 GUID의 이름은 추적 공급자 가 빌드된 디렉터리의 이름입니다. 메시지 GUID의 이름을 변경하려면 Tracewpp 또는 RUN_WPP 매크로와 함께 -p 매개 변수를 사용합니다. 자세한 내용은 Run_WPP 옵션을 참조하세요.
%2	문자열	원본 파일 및 줄 번호입니다. 이 변수는 추적 메시지의 이름을 나타냅니다. 기본적으로 추적 메시지의 식별 이름은 원본 파일의 이름과 추적 메시지를 생성한 코드의 줄 번호입니다.
%3	ULONG	스레드 ID입니다. 추적 메시지를 생성한 스레드를 식별합니다.
%4	문자열	추적 메시지가 생성된 시간의 타임스탬프를 지정합니다.
%5	문자열	커널 시간. 추적 메시지가 생성된 시점의 커널 모드 명령에 대한 경과된 실행 시간을 CPU 틱으로 표시합니다.
%6	문자열	사용자 시간. 추적 메시지가 생성된 시점의 사용자 모드 명령에 대한 경과된 실행 시간을 CPU 틱으로 표시합니다.
%7	LONG	시퀀스 번호입니다. 추적 메시지의 로컬 또는 전역 시퀀스 번호를 표시합니다. 이 추적 세션에만 고유한 로컬 시퀀스 번호가 기본값입니다.
%8	ULONG	프로세스 ID입니다. 추적 메시지를 생성한 프로세스를 식별합니다.
%9	ULONG	CPU 번호입니다. 추적 메시지가 생성된 CPU를 식별합니다.
%! Func!	문자열	함수 이름. 추적 메시지를 생성한 함수의 이름을 표시합니다.
%! 플래그!	문자열	추적 메시지를 사용하도록 설정하는 추적 플래그 의 이름을 표시합니다. DoTraceMessage 매크로는 플래그 및 수준 인수를 반대로 하기 때문에 DoTraceMessage에서 생성된 메시지는 이 필드에 추적 수준 값을 표시합니다.
%! 수준!	문자열	추적 메시지를 사용하도록 설정하는 추적 수준의 값을 표시합니다. DoTraceMessage 매크로는 플래그 및 수준 인수를 반대로 하기 때문에 DoTraceMessage에서 생성된 메시지는 이 필드에 추적 플래그의 이름을 표시합니다.
%! COMPNAME!	문자열	구성 요소 이름입니다. 추적 메시지를 생성한 공급자의 구성 요소 이름을 표시합니다. 구성 요소 이름은 추적 코드에 지정된 경우에만 나타납니다.
%! SUBCOMP!	문자열	하위 구성 요소 이름입니다. 추적 메시지를 생성한 공급자의 하위 구성 요소 이름을 표시합니다. 구성 요소 이름은 추적 코드에 지정된 경우에만 나타납니다.

느낌표 내의 기호는 변수의 서식 및 전체 자릿수를 지정하는 변환 문자입니다. 예를 들어 %8!04X! 는 4자리 부호 없는 16진수로 표시되는 프로세스 ID를 지정합니다. 이러한 변환 문자를 포함해야 합니다.

추적 메시지 접두사 요소, 순서 또는 서식을 변경하려면 %TRACE_FORMAT_PREFIX% 환경 변수를 사용합니다. 예제는 예제 7: 추적 메시지 접두사 사용자 지정을 참조하세요.

TMF 파일의 콘텐츠 예제는 tracedrv 샘플에서 추적 메시지 서식 지정을 참조하세요.

또한 -csv 매개 변수는 표준 Tracefmt 접두사 앞에 각 추적 메시지에 구성할 수 없는 자세한 접두사를 추가합니다. CSV 접두사에서 필드에 대한 설명을 보려면 -csvheader 매개 변수를 사용합니다.