추적 공급자에 WPP 매크로 추가

커널 모드 드라이버 또는 사용자 모드 애플리케이션과 같은 추적 공급자에 WPP 소프트웨어 추적의 기본 형식을 추가하려면 다음 C 전처리기 지시문 및 WPP 매크로 호출을 공급자의 소스 코드에 추가합니다.

• WPP 매크로가 포함된 각 원본 파일에 대한 다음 양식의 #include 지시문입니다. 이 문에는 각 원본 파일에 대해 WPP 전처리기에서 만든 추적 메시지 헤더 파일이 포함됩니다.

  #include <source-file-name.tmh>
  

  추적 메시지 헤더 파일은 WPP 매크로가 호출되기 전과 WPP_CONTROL_GUIDS 매크로를 정의한 후 원본 파일에 포함되어야 합니다.

• 다른 WPP 매크로를 포함하는 각 원본 파일에 대한 WPP_CONTROL_GUIDS 정의 지시문입니다.

  이 정의는 드라이버의 컨트롤 GUID 및 드라이버 정의 추적 플래그 이름을 지정합니다. 정의는 파일의 추적 메시지 헤더 파일을 포함하는 #include 문 앞에 원본 파일에 추가해야 합니다.

• 드라이버의 소스 코드에 대한 하나의 WPP_INIT_TRACING 매크로 호출입니다.

  드라이버의 경우 이 매크로는 드라이버에서 소프트웨어 추적을 활성화합니다. 이 매크로는 일반적으로 드라이버 초기화 중에 호출됩니다(예: DriverEntry 루틴).

  사용자 모드 애플리케이션의 경우 이전에 추적 시도가 없었던 소스 코드의 지점에서 이 매크로를 호출합니다.

  초기화 후 TraceView 또는 Tracelog 를 사용하여 소프트웨어 추적 세션을 시작하고 추적 메시지를 표시할 수 있습니다.

• 추적 공급자의 소스 코드에 대한 하나의 WPP_CLEANUP 매크로 호출입니다. 이 매크로는 드라이버에서 소프트웨어 추적을 비활성화합니다.

  드라이버의 경우 이 매크로 호출은 일반적으로 드라이버의 언로드 루틴에 추가됩니다.

  사용자 모드 애플리케이션의 경우 마지막 추적 시도가 수행된 후 소스 코드의 한 지점에서 이 매크로를 호출합니다.

• DoTraceMessage 매크로는 추적 메시지를 기록하기 위해 를 호출합니다.