다음을 통해 공유

추적 메시지 형식 파일

  • 아티클

TMF( 추적 메시지 형식 ) 파일은 추적 공급자 가 생성하는 이진 추적 메시지를 구문 분석하고 서식을 지정하는 지침을 포함하는 구조화된 텍스트 파일입니다. 서식 지정 지침은 추적 공급자의 소스 코드에 포함되며 WPP 전처리기에서 추적 공급자의 PDB 기호 파일에 추가됩니다.

서식이 지정된 추적 메시지를 기록하고 표시하는 일부 도구에는 TMF 파일이 필요합니다. 추적 메시지의 서식을 지정하고 표시하는 WDK 도구인 Tracefmt 및 TraceView는 TMF 파일을 사용하거나 PDB 기호 파일에서 직접 서식 정보를 추출할 수 있습니다.

Tracefmt를 사용하고 Tracefmt가 Tracedrv에 대한 TMF 파일을 만들도록 지시하는 -i 매개 변수를 포함하여 TMF 파일을 만들 수 있습니다. 자세한 내용은 예제 9: TMF 파일 만들기를 참조하세요.

추적 공급자에 대한 TMF 파일이 없는 경우 Tracepdb를 사용합니다. Tracepdb는 PDB 기호 파일에서 서식 지정 지침을 추출하고 이를 저장할 TMF 파일을 만듭니다. 많은 애플리케이션 및 드라이버 개발자는 PDB 기호 파일보다는 TMF 파일을 배송하는 것을 선호합니다.

TMF 파일의 이름은 해당 TMF 파일과 연결된 메시지의 메시지 GUID 입니다. ETW는 메시지 GUID를 사용하여 특정 추적 메시지를 해당 형식 지정 지침이 포함된 TMF 파일과 연결합니다.

TMF 파일에는 다음 데이터가 포함됩니다.

  • TMF 파일 데이터가 추출된 PDB 파일의 이름입니다.

  • 원본 파일 및 원본 파일 이름에 있는 추적 메시지의 메시지 GUID 입니다.

  • 각 추적 메시지에 대해 메시지 유형, 소스 코드 파일 이름, 줄 번호, 메시지 번호, 메시지 정의 문자열, 추적 플래그 이름 및 매크로 호출을 포함하는 C 함수의 이름을 지정하는 항목입니다.

  • 해당 값이 추적 메시지 및 관련 내부 형식 이름에 표시되는 변수 목록입니다. 변수는 메시지 정의 문자열에서 %n 표기법으로 표시됩니다.

참고 TMF 파일은 내부용으로 예약되어 있으며 해당 형식은 다른 버전의 Windows 간에 변경될 수 있습니다.