Класс 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 имеет следующие типы членов:

• Свойства

Элемент Property

Класс EventTrace_Header имеет следующие свойства.

BootTime

Тип данных: uint64

Тип доступа: только для чтения

Квалификаторы: WmiDataId (17)

Время, когда система была запущена, в 100-наносекунд интервалы с полуночи, 1 января 1601 года.

BufferSize

Тип данных: uint32

Тип доступа: только для чтения

Квалификаторы: WmiDataId (1)

Размер буферов сеанса трассировки событий в килобайтах.

BuffersLost

Тип данных: uint32

Тип доступа: только для чтения

Квалификаторы: WmiDataId (21)

Общее число потерянных буферов.

BuffersWritten

Тип данных: uint32

Тип доступа: только для чтения

Квалификаторы: WmiDataId (9)

Общее количество буферов, записанных сеансом трассировки событий.

CpuSpeed

Тип данных: uint32

Тип доступа: только для чтения

Квалификаторы: WmiDataId (13)

Скорость ЦП, в мегагерцах.

Windows 2000: Не поддерживается.

EndTime

Тип данных: uint64

Тип доступа: только для чтения

Квалификаторы: WmiDataId (5)

Время остановки сеанса трассировки событий с интервалом в 100 наносекунд с полуночи 1 января 1601 г. Это значение может быть равно 0, если вы используете события в режиме реального времени или из файла журнала, в который по-прежнему регистрирует события.

EventsLost

Тип данных: uint32

Тип доступа: только для чтения

Квалификаторы: WmiDataId (12)

Число событий, потерянных во время сеанса трассировки событий.

LogFileMode

Тип данных: uint32

Тип доступа: только для чтения

Квалификаторы: WmiDataId (8), Format("x")

Текущий режим ведения журнала для сеанса трассировки событий. Список значений см. в разделе Константы режима ведения журнала.

Имя_журнала

Тип данных: uint32

Тип доступа: только для чтения

Квалификаторы: WmiDataId (15), указатель

Имя файла журнала трассировки событий, содержащего события.

LoggerName

Тип данных: uint32

Тип доступа: только для чтения

Квалификаторы: WmiDataId (14), указатель

Имя сеанса трассировки событий.

Maxfilesize

Тип данных: uint32

Тип доступа: только для чтения

Квалификаторы: WmiDataId (7)

Максимальный размер файла журнала в мегабайтах.

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)

Время начала сеанса трассировки событий в 100-наносекундных интервалах с полуночи, 1 января 1601 г.

TimerResolution

Тип данных: uint32

Тип доступа: только для чтения

Квалификаторы: WmiDataId (6)

Разрешение аппаратного таймера в единицах 100 наносекунд.

TimeZoneInformation

Тип данных: массив uint8

Тип доступа: только для чтения

Квалификаторы: WmiDataId (16), Extension("NoPrint"), Max (176)

Структура TIME_ZONE_INFORMATION , содержащая часовой пояс для элементов BootTime, EndTime и StartTime .

Версия

Тип данных: uint32

Тип доступа: только для чтения

Квалификаторы: WmiDataId (2)

Номер версии операционной системы. Начиная с байтов низкого порядка, первые два байта содержат основную версию, следующие два байта содержат дополнительную версию, следующие два байта содержат основную версию пакета обновления, а последние два байта — дополнительную версию пакета обновления.

Комментарии

Как правило, требуется сохранить значения следующих свойств для последующего использования при обработке событий из файла журнала.

• TimerResolution — используйте с элементами KernelTime и UserTime структуры EVENT_TRACE_HEADER , чтобы определить затраты на ЦП для набора инструкций. Дополнительные сведения см. в разделе Примечания EVENT_TRACE_HEADER.
• PointerSize — для свойств, содержащих квалификатор указателя , используйте это значение для определения размера указателя. Обратите внимание, что это значение может быть неверным. Например, на 64-разрядном компьютере 32-разрядное приложение регистрирует 4-байтовые указатели; однако сеанс установит для параметра PointerSize значение 8.
• LogFileMode — используется для определения того, является ли этот сеанс частным сеансом средства ведения журнала. Существуют некоторые свойства, которые не содержат данных для частных сеансов средства ведения журнала. Например, элементы KernelTime и UserTimeструктуры EVENT_TRACE_HEADER .

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]

См. также раздел

EventTraceEvent

TRACE_LOGFILE_HEADER