TDH_CONTEXT_TYPE 열거형(tdh.h)

  • 아티클

컨텍스트 형식을 정의합니다.

Syntax

typedef enum _TDH_CONTEXT_TYPE {
  TDH_CONTEXT_WPP_TMFFILE,
  TDH_CONTEXT_WPP_TMFSEARCHPATH,
  TDH_CONTEXT_WPP_GMT,
  TDH_CONTEXT_POINTERSIZE,
  TDH_CONTEXT_PDB_PATH,
  TDH_CONTEXT_MAXIMUM
} TDH_CONTEXT_TYPE;

상수

 
TDH_CONTEXT_WPP_TMFFILE
WPP 로그를 구문 분석하는 데 사용되는 .tmf 파일의 이름을 포함하는 Null로 종료된 유니코드 문자열입니다. 일반적으로 .tmf 파일 이름은 이벤트 GUID에서 선택되므로 파일 이름을 지정할 필요가 없습니다.
TDH_CONTEXT_WPP_TMFSEARCHPATH
.tmf 파일의 경로를 포함하는 Null로 종료된 유니코드 문자열입니다. 검색 경로에 파일이 포함된 경우 이 경로를 지정할 필요가 없습니다. TDH_CONTEXT_WPP_TMFFILE 컨텍스트 형식도 지정하는 경우에만 이 컨텍스트 정보를 지정합니다. 파일을 찾을 수 없는 경우 TDH는 지정된 순서로 다음 위치를 검색합니다.


  • TRACE_FORMAT_SEARCH_PATH 환경 변수에 지정된 경로

  • 현재 폴더
TDH_CONTEXT_WPP_GMT
WPP 이벤트 타임스탬프를 UTC(유니버설 타임 좌표)로 변환해야 하는지 여부를 나타내는 1 바이트 부울 플래그입니다. 1이면 타임스탬프는 UTC로 변환됩니다. 0이면 타임스탬프는 현지 시간으로 표시됩니다. 기본적으로 타임스탬프는 현지 시간에 있습니다.
TDH_CONTEXT_POINTERSIZE
이벤트에 사용되는 포인터 데이터 형식 또는 size_t 데이터 형식의 크기(바이트)입니다. 이벤트가 4 바이트 또는 8 바이트 값을 사용했는지 여부를 나타냅니다. 기본적으로 포인터 크기는 디코딩 컴퓨터의 포인터 크기입니다.

포인터 또는 size_t 값의 크기를 확인하려면 TRACE_LOGFILE_HEADERPointerSize 멤버를 사용합니다(EventRecordCallback 콜백에서 수신하는 첫 번째 이벤트에는 데이터 섹션에 이 헤더가 포함됨). 그러나 이 값은 정확하지 않을 수 있습니다. 예를 들어 64비트 컴퓨터에서 32비트 애플리케이션은 4비트 포인터를 기록합니다. 그러나 세션은 PointerSize 를 8로 설정합니다.
TDH_CONTEXT_PDB_PATH
WPP 메시지를 포함하는 이진 파일에 대한 .pdb 파일의 이름을 포함하는 Null로 종료된 유니코드 문자열입니다. 이 매개 변수는 TDH_CONTEXT_WPP_TMFFILE 또는TDH_CONTEXT_WPP_TMFSEARCHPATH 대신 사용할 수 있습니다.

참고 Windows 8 및 Windows Server 2012만 사용할 수 있습니다.

 
TDH_CONTEXT_MAXIMUM
예약되어 있습니다.

설명

레거시 ETW 이벤트에 대한 컨텍스트 정보를 지정하는 경우 TDH_CONTEXT_POINTERSIZE 형식만 지정하면 됩니다. 다른 형식은 WPP 이벤트에 사용되며 레거시 ETW 이벤트에는 무시됩니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2008 [데스크톱 앱만 해당]
머리글 tdh.h

추가 정보

TDH_CONTEXT