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、EndTime和StartTime成員時區的TIME_ZONE_INFORMATION結構。

版本

資料類型： uint32

存取類型：唯讀

限定詞： WmiDataId (2)

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

備註

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

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

規格需求

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

另請參閱

EventTraceEvent

TRACE_LOGFILE_HEADER