다음을 통해 공유


WPP 확장 형식 사양 문자열이란?

WPP에는 printf에 대해 정의된 표준 형식 문자열 외에도 추적 메시지에 사용할 수 있는 미리 정의된 형식 사양 문자열이 포함되어 있습니다.

%!FLAGS!, %!FUNC!%!LEVEL! 문자열을 추적 메시지 접두사DoTraceMessage와 같은 모든 추적 함수나 매크로에서 사용할 수 있습니다.

추적 함수에서 다른 확장 문자열을 사용할 수 있습니다.

tracewpp에 대한 기본 구성 옵션

WPP는 기본 구성 설정에 "defaultwpp.ini"를 사용합니다. 이 기본 INI 파일은 WppConfig Rev1 디렉터리에 Windows SDK의 일부로 포함됩니다. WPP 기본 동작에 대한 최신 정보와 사용자 지정에 대한 추가 정보는 이 INI 파일을 참조하세요.

소프트웨어 추적

문자열 서식 지정 설명
%!파일! 추적 메시지가 생성된 원본 파일의 이름을 표시합니다. 이 변수는 추적 메시지 접두사에서도 사용할 수 있습니다.
%!플래그! 추적 메시지를 사용하도록 설정하는 추적 플래그 의 값을 표시합니다. 이 변수는 추적 메시지 접두사에서도 사용할 수 있습니다.
%! FUNC! 추적 메시지를 생성한 함수를 표시합니다. 이 변수는 추적 메시지 접두사에서도 사용할 수 있습니다.
%!수준! 추적 메시지를 사용하도록 설정하는 추적 수준의 이름을 표시합니다. 이 변수는 추적 메시지 접두사에서도 사용할 수 있습니다.
%!LINE! 추적 접두사를 생성한 코드의 줄 번호를 표시합니다. 이 변수는 추적 메시지 접두사에서도 사용할 수 있습니다.

일반 사용

문자열 서식 지정 설명
%!bool! TRUE 또는 FALSE를 표시합니다.
%!irql! 현재 IRQL의 이름을 표시합니다.
%!sid! pSID(보안 식별자)에 대한 포인터를 나타냅니다. SID를 표시합니다.
GUID들
%!GUID! GUID(pGUID)에 대한 포인터를 나타냅니다. 가리키는 GUID를 표시합니다.
%! CLSID! 클래스 ID입니다. 클래스 ID GUID에 대한 포인터를 나타냅니다. GUID와 연결된 문자열을 표시합니다. WPP는 추적 메시지의 형식을 지정할 때 레지스트리에서 문자열을 찾습니다.
%! LIBID! 형식 라이브러리입니다. COM 형식 라이브러리의 GUID를 나타냅니다. GUID와 연결된 문자열을 표시합니다. WPP는 추적 메시지의 형식을 지정할 때 레지스트리에서 문자열을 찾습니다.
%! IID! 인터페이스 ID입니다. 인터페이스 ID GUID에 대한 포인터를 나타냅니다. GUID와 연결된 문자열을 표시합니다. WPP는 추적 메시지의 형식을 지정할 때 레지스트리에서 문자열을 찾습니다.
Time
%!delta! 두 시간 값의 차이를 밀리초 단위로 표시합니다. day~h:m:s 형식으로 표시되는 LONGLONG 값입니다.
%! WAITTIME! 완료되기를 기다리는 데 소요된 시간(밀리초)을 표시합니다. day~h:m:s 형식으로 표시되는 LONGLONG 값입니다. %!due!와 함께 사용하도록 설계되었습니다.
%!기한! 작업이 완료될 것으로 예상되는 시간(밀리초)을 표시합니다. day~h:m:s 형식으로 표시되는 LONGLONG 값입니다. %!WAITTIME!와 함께 사용하도록 설계되었습니다.
%! 시간 표시!
%!datetime!
%! 시간!
특정 순간에 시스템 시간의 값을 표시합니다. SYSTEMTIME 형식으로 표시되는 LONGLONG(SINT64) 값입니다.
이러한 변수를 사용하여 프로그램에서 다른 시간 값을 나타내고 서로 구별할 수 있습니다.

반환 코드

문자열 서식 지정 설명
%! 상태! 상태 값을 나타내고 상태 코드와 연결된 문자열을 표시합니다.
%! !WINERROR! Windows 오류 코드를 나타내고 오류와 연결된 문자열을 표시합니다.
%! HRESULT! 오류 또는 경고를 나타내고 코드를 HRESULT 형식으로 표시합니다.

네트워크

문자열 서식 지정 설명
%! IPADDR! IP 주소에 대한 포인터를 나타냅니다. IP 주소를 표시합니다.
%! 항구! 포트 번호를 표시합니다.