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 速度，以兆赫为单位。

Windows 2000： 不支持。

EndTime

数据类型： uint64

访问类型：只读

限定符： WmiDataId (5)

事件跟踪会话停止的时间，自 1601 年 1 月 1 日午夜以来的 100 纳秒间隔。 如果实时使用事件，或者从提供的事件仍在记录事件的日志文件中，则此值可能为 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”) ， 最大 (176)

包含 BootTime、EndTime 和 StartTime 成员时区的TIME_ZONE_INFORMATION结构。

Version

数据类型： 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 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]

另请参阅

EventTraceEvent

TRACE_LOGFILE_HEADER