共用方式為


EventTrace_Header 類別

記錄檔頭事件的事件種類類別。 這個類別包含事件追蹤會話的相關資訊。

下列語法是從 MOF 程式碼簡化的。

語法

[EventType(0)]
class EventTrace_Header : EventTraceEvent
{
  uint32 BufferSize;
  uint32 Version;
  uint32 ProviderVersion;
  uint32 NumberOfProcessors;
  uint64 EndTime;
  uint32 TimerResolution;
  uint32 MaxFileSize;
  uint32 LogFileMode;
  uint32 BuffersWritten;
  uint32 StartBuffers;
  uint32 PointerSize;
  uint32 EventsLost;
  uint32 CPUSpeed;
  uint32 LoggerName;
  uint32 LogFileName;
  uint8  TimeZoneInformation[];
  uint64 BootTime;
  uint64 PerfFreq;
  uint64 StartTime;
  uint32 ReservedFlags;
  uint32 BuffersLost;
};

成員

EventTrace_Header類別具有下列類型的成員:

屬性

EventTrace_Header類別具有這些屬性。

BootTime

資料類型: uint64

存取類型:唯讀

限定詞: WmiDataId (17)

系統啟動時,從 1601 年 1 月 1 日午夜起的 100 奈秒間隔。

BufferSize

資料類型: uint32

存取類型:唯讀

限定詞: WmiDataId (1)

事件追蹤會話緩衝區的大小,以 KB 為單位。

BuffersLost

資料類型: uint32

存取類型:唯讀

限定詞: WmiDataId (21)

遺失的緩衝區總數。

BuffersWritten

資料類型: uint32

存取類型:唯讀

限定詞: WmiDataId (9)

事件追蹤會話所寫入的緩衝區總數。

CPUSpeed

資料類型: uint32

存取類型:唯讀

限定詞: WmiDataId (13)

CPU 速度,以 MB 為單位。

Windows 2000: 不支援。

EndTime

資料類型: uint64

存取類型:唯讀

限定詞: WmiDataId (5)

事件追蹤會話停止的時間,間隔為 100 奈秒,自 1601 年 1 月 1 日午夜起。 如果您要即時取用事件,或從提供仍在記錄事件的記錄檔中取用事件,這個值可能是 0。

EventsLost

資料類型: uint32

存取類型:唯讀

限定詞: WmiDataId (12)

事件追蹤會話期間遺失的事件數目。

LogFileMode

資料類型: uint32

存取類型:唯讀

限定詞: WmiDataId (8) , 格式 (「x」)

事件追蹤會話目前的記錄模式。 如需值清單,請參閱記錄模式常數。

LogFileName

資料類型: uint32

存取類型:唯讀

限定詞: WmiDataId (15) , 指標

包含事件的事件追蹤記錄檔名稱。

LoggerName

資料類型: uint32

存取類型:唯讀

限定詞: WmiDataId (14) , 指標

事件追蹤會話的名稱。

MaxFileSize

資料類型: uint32

存取類型:唯讀

限定詞: WmiDataId (7)

記錄檔的大小上限,以 MB 為單位。

NumberOfProcessors

資料類型: uint32

存取類型:唯讀

限定詞: WmiDataId (4)

系統上的處理器數目。

PerfFreq

資料類型: uint64

存取類型:唯讀

限定詞: WmiDataId (18)

如果存在,則為高解析度效能計數器的頻率。

PointerSize

資料類型: uint32

存取類型:唯讀

限定詞: WmiDataId (11)

指標資料類型的大小,以位元組為單位。

ProviderVersion

資料類型: uint32

存取類型:唯讀

限定詞: WmiDataId (3)

作業系統的組建編號。

ReservedFlags

資料類型: uint32

存取類型:唯讀

限定詞: WmiDataId (20)

保留的。

StartBuffers

資料類型: uint32

存取類型:唯讀

限定詞: WmiDataId (10)

保留的。

StartTime

資料類型: uint64

存取類型:唯讀

限定詞: WmiDataId (19)

事件追蹤會話啟動的時間,從 1601 年 1 月 1 日午夜起,以 100 奈秒的間隔為單位。

TimerResolution

資料類型: uint32

存取類型:唯讀

限定詞: WmiDataId (6)

硬體計時器解析度,單位為 100 奈秒。

TimeZoneInformation

資料類型: uint8 陣列

存取類型:唯讀

限定詞: WmiDataId (16) , 擴充功能 (「NoPrint」) Max (176)

包含BootTime、EndTimeStartTime成員時區的TIME_ZONE_INFORMATION結構。

版本

資料類型: uint32

存取類型:唯讀

限定詞: WmiDataId (2)

作業系統的版本號碼。 從低序位元組開始,前兩個位元組包含主要版本、下兩個位元組包含次要版本、下兩個位元組包含 Service Pack 主要版本,最後兩個位元組包含 Service Pack 次要版本。

備註

一般而言,您想要儲存下列屬性的值,以供稍後在處理記錄檔的事件時使用。

  • TimerResolution - 搭配EVENT_TRACE_HEADER結構的KernelTimeUserTime成員使用,以判斷一組指令的 CPU 成本。 如需詳細資訊,請參閱 EVENT_TRACE_HEADER的一節。
  • PointerSize - 對於包含 指標 限定詞的屬性,請使用此值來判斷指標的大小。 請注意,此值可能不正確。 例如,在 64 位電腦上,32 位應用程式會記錄 4 位元組指標;不過,會話會將 PointerSize 設定為 8。
  • LogFileMode - 用來判斷此會話是否為私人記錄器會話。 有一些屬性不包含私人記錄器會話的資料。 例如,EVENT_TRACE_HEADER結構的KernelTimeUserTime成員。

規格需求

需求
最低支援的用戶端
Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器
Windows 2000 Server [僅限傳統型應用程式]

另請參閱

EventTraceEvent

TRACE_LOGFILE_HEADER