共用方式為

OpenTraceFromRealTimeLogger 函式 （evntrace.h）

  • 發行項

建立附加至作用中即時 ETW 工作階段的追蹤處理工作階段。

語法

ETW_APP_DECLSPEC_DEPRECATED PROCESSTRACE_HANDLE WMIAPI OpenTraceFromRealTimeLogger(
  PCWSTR                       LoggerName,
  const ETW_OPEN_TRACE_OPTIONS *Options,
  TRACE_LOGFILE_HEADER         *LogFileHeader
);

參數

LoggerName

即時事件追蹤會話的名稱，或從記錄檔處理數據時 NULL。 如果您要呼叫 OpenTraceFromRealTimeLogger 以從即時會話取用數據，請指定這個成員的值。

呼叫 OpenTraceFromRealTimeLogger時，如果 logFileHeader 為非NULL，則必須 LoggerNameNULL。

只有當追蹤控制器已設定 LogFileMode 成員 EVENT_TRACE_PROPERTIES 以包含 EVENT_TRACE_REAL_TIME_MODE 旗標時，您才能即時取用事件。

只有具有系統管理許可權的使用者、效能記錄使用者群組中的使用者，以及以LocalSystem、LocalService、NetworkService身分執行的應用程式，才能即時取用事件。 若要授與受限制的用戶即時取用事件的能力，請將事件新增至 Performance Log Users 群組，或呼叫 EventAccessControl。

Options

此處理工作階段的組態選項。 如需詳細資訊，請參閱 ETW_OPEN_TRACE_OPTIONS。

LogFileHeader

記錄檔的標頭資訊。 如需詳細資訊，請參閱 TRACE_LOGFILE_HEADER。

傳回值

用來識別此處理會話的 TRACEHANDLE。 通常傳遞至 ProcessTrace，開始處理，並 CloseTrace 結束處理。

言論

一旦 ProcessTrace 在傳回 TRACEHANDLE上呼叫之後，這會在排清 ETW 會話時接收緩衝區，並立即開始處理它們，並呼叫 Options中指定的回呼。

要求

要求 價值
最低支援的用戶端 Windows 11 2022 Update
支援的最低伺服器 Windows Server 2022
目標平臺 窗戶
標頭 evntrace.h
連結庫 Advapi32.dll
DLL Sechost.dll Windows 8.1 和 Windows Server 2012 R2;Windows 8、Windows Server 2012、Windows 7、Windows Server 2008 R2、Windows Server 2008、Windows Vista 和 Windows XP 上的 Advapi32.dll