추적 메시지 접두사

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

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

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

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

다음 접두사 생성:

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

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

접두사 변수 식별자	변수 유형	설명
%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 매개 변수를 사용합니다.