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 專業版 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器	Windows 2000 Server [傳統型應用程式 |UWP 應用程式]
標頭	evntrace.h