!wmitrace.searchpath

!wmitrace.searchpath 확장은 추적 버퍼의 메시지에 대한 추적 메시지 형식 파일의 위치를 지정합니다.

!wmitrace.searchpath [+] TMFPath 
!wmitrace.searchpath

매개 변수

+
기존 검색 경로에 TMFPath를 추가합니다. 더하기(+) 토큰을 사용하지 않으면 TMFPath 는 기존 검색 경로를 대체합니다.

TMFPath
디버거가 추적 메시지 형식 파일을 찾아야 하는 디렉터리의 경로입니다. 공백이 포함된 경로는 지원되지 않습니다. 여러 경로가 포함된 경우 세미콜론으로 구분해야 하며 전체 문자열을 따옴표로 묶어야 합니다. 경로가 따옴표로 묶인 경우 백슬래시 문자 앞에 이스케이프 문자( "c:\\debuggers;c:\\debuggers2" )가 와야 합니다. 토큰을 + 사용하면 기존 경로와 새 경로 사이에 세미콜론이 자동으로 삽입되는 기존 경로에 TMFPath 가 추가되지만 토큰을 사용하는 경우 + 따옴표를 사용할 수 없습니다.

DLL

Wmitrace.dll

이 확장은 Windows 2000 이상 버전의 Windows에서 사용할 수 있습니다. Windows 2000에서 이 확장을 사용하려면 먼저 Windows용 디버깅 도구 설치 디렉터리의 winxp 하위 디렉터리에서 w2kfre 하위 디렉터리로 Wmitrace.dll 파일을 복사해야 합니다.

추가 정보

이벤트 추적에 대한 개념적 개요는 Microsoft Windows SDK를 참조하세요. 추적 메시지 형식 파일에 대한 자세한 내용은 WDK(Windows 드라이버 키트)의 "추적 메시지 형식 파일" 항목을 참조하세요.

설명

매개 변수 없이 사용할 경우 !wmitrace.searchpath 는 현재 검색 경로를 표시합니다.

추적 메시지 형식 파일(*.tmf)에는 추적 공급자가 생성하는 이진 추적 메시지의 서식을 지정하는 지침이 포함되어 있습니다.

TMFPath 매개 변수는 디렉터리에 대한 경로만 포함해야 하며 파일 이름을 포함할 수 없습니다. TMF 파일의 이름은 메시지 GUID 뒤에 .tmf 확장명을 붙입니다. 시스템에서 메시지 형식을 지정하면 메시지의 메시지 GUID를 읽고 지정된 디렉터리에서 시작하여 이름이 메시지 GUID와 일치하는 TMF 파일을 재귀적으로 검색합니다.

버퍼에서 이진 추적 메시지의 형식을 지정하려면 Windows에 TMF 파일이 필요합니다. !wmitrace.dynamicprint 또는 !wmitrace.logdump를 사용하여 추적 버퍼 내용을 표시하기 전에 !wmitrace.searchpath 또는 !wmitrace.tmffile을 사용하여 TMF 파일을 지정합니다.

!wmitrace.searchpath 또는 !wmitrace.tmffile을 사용하지 않는 경우 시스템은 TRACE_FORMAT_SEARCH_PATH 환경 변수의 값을 사용합니다. 해당 변수가 없으면 Windows에 포함된 default.tmf 파일을 사용합니다. 시스템에서 추적 메시지에 대한 서식 정보를 찾을 수 없는 경우 추적 메시지 콘텐츠 대신 "형식 정보를 찾을 수 없음" 오류 메시지를 씁니다.