ETW_OPEN_TRACE_OPTIONS 구조체(evntrace.h)

OpenTraceFromBufferStream, OpenTraceFromFile, OpenTraceFromRealTimeLogger, OpenTraceFromRealTimeLoggerWithAllocationOptions 함수에 대한 구성 매개 변수를 제공합니다.

구문

typedef struct ETW_OPEN_TRACE_OPTIONS {
  ETW_PROCESS_TRACE_MODES ProcessTraceModes;
  PEVENT_RECORD_CALLBACK  EventCallback;
  void                    *EventCallbackContext;
  PETW_BUFFER_CALLBACK    BufferCallback;
  void                    *BufferCallbackContext;
} ETW_OPEN_TRACE_OPTIONS;

멤버

ProcessTraceModes

처리 세션에 대한 추가 구성을 제공하는 비트 필드 열거형입니다. 현재 지원되는 값:

• ETW_PROCESS_TRACE_MODE_NONE
• ETW_PROCESS_TRACE_MODE_RAW_TIMESTAMP – EventCallback에 제공된 EVENT_RECORD 타임스탬프는 기본적으로 파일 시간으로 변환되지 않습니다. 대신 원래 이벤트의 클록 형식(예: QueryPerformanceCounter, CPU 타임스탬프 카운터 또는 GetSystemTimeAsFileTime)에 유지됩니다.

EventCallback

PEVENT_RECORD_CALLBACK 형식의 함수 포인터입니다. 각 이벤트에 대해 시간 순서로 호출합니다. NULL이면 성능 향상을 위해 모든 이벤트 재생 처리가 무시됩니다.

EventCallbackContext

EVENT_RECORD 사용할 수 있는 사용자 정의 컨텍스트입니다. EventCallback 내의 UserContext입니다.

BufferCallback

해당 버퍼에서 처리가 완료되면 각 버퍼에 대해 호출됩니다. NULL이면 버퍼 콜백이 실행되지 않습니다.

BufferCallbackContext

BufferCallback에 CallbackContext 매개 변수로 전달될 사용자 정의 컨텍스트입니다.

요구 사항

지원되는 최소 클라이언트	Windows 2000 Professional [데스크톱 앱 | UWP 앱]
지원되는 최소 서버	Windows 2000 Server [데스크톱 앱 | UWP 앱]
머리글	evntrace.h