структура WHEA_ERROR_PACKET_V1 (ntddk.h)

Статья
03/08/2023

Структура WHEA_ERROR_PACKET_V1 описывает данные об ошибках оборудования, которые передаются в операционную систему низкоуровневой аппаратной обработчиком ошибок (LLHEH).

Структура WHEA_ERROR_PACKET_V1 поддерживается в Windows Server 2008 и Windows Vista с пакетом обновления 1 (SP1).

Для Windows 7 и более поздних версий Windows используйте структуру WHEA_ERROR_PACKET_V2 .

Синтаксис

typedef struct _WHEA_ERROR_PACKET_V1 {
  ULONG                   Signature;
  WHEA_ERROR_PACKET_FLAGS Flags;
  ULONG                   Size;
  ULONG                   RawDataLength;
  ULONGLONG               Reserved1;
  ULONGLONG               Context;
  WHEA_ERROR_TYPE         ErrorType;
  WHEA_ERROR_SEVERITY     ErrorSeverity;
  ULONG                   ErrorSourceId;
  WHEA_ERROR_SOURCE_TYPE  ErrorSourceType;
  ULONG                   Reserved2;
  ULONG                   Version;
  ULONGLONG               Cpu;
  union {
    WHEA_PROCESSOR_GENERIC_ERROR_SECTION ProcessorError;
    WHEA_MEMORY_ERROR_SECTION            MemoryError;
    WHEA_NMI_ERROR_SECTION               NmiError;
    WHEA_PCIEXPRESS_ERROR_SECTION        PciExpressError;
    WHEA_PCIXBUS_ERROR_SECTION           PciXBusError;
    WHEA_PCIXDEVICE_ERROR_SECTION        PciXDeviceError;
    WHEA_PMEM_ERROR_SECTION              PmemError;
  } u;
  WHEA_RAW_DATA_FORMAT    RawDataFormat;
  ULONG                   RawDataOffset;
  UCHAR                   RawData[1];
} WHEA_ERROR_PACKET_V1, *PWHEA_ERROR_PACKET_V1, WHEA_ERROR_PACKET, *PWHEA_ERROR_PACKET;

Члены

Signature

Сигнатура пакета ошибок оборудования. Этот элемент содержит значение WHEA_ERROR_PACKET_V1_SIGNATURE.

Flags

Объединение WHEA_ERROR_PACKET_FLAGS, описывающее условие ошибки.

Size

Размер (в байтах) пакета ошибок оборудования, включая необработанные данные.

RawDataLength

Длина (в байтах) данных, содержащихся в элементе RawData .

Reserved1

Зарезервировано для системного использования.

Context

Зарезервировано для системного использования.

ErrorType

WHEA_ERROR_TYPE типизированное значение, указывающее тип аппаратного компонента, который сообщил об ошибке оборудования.

ErrorSeverity

WHEA_ERROR_SEVERITY типизированное значение, указывающее серьезность условия ошибки.

ErrorSourceId

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

ErrorSourceType

WHEA_ERROR_SOURCE_TYPE типизированное значение, указывающее тип источника ошибки, который сообщил об ошибке оборудования.

Reserved2

Зарезервировано для системного использования.

Version

Версия структуры WHEA_ERROR_PACKET_V1. Этот элемент содержит значение WHEA_ERROR_PKT_V1VERSION.

Cpu

Зарезервировано для системного использования.

u

Объединение, состоящее из следующих членов:

u.ProcessorError

Структура WHEA_PROCESSOR_GENERIC_ERROR_SECTION , описывающая данные об ошибках процессора. Этот элемент используется только в том случае, если для элемента ErrorType задано значение WheaErrTypeProcessor.

u.MemoryError

Структура WHEA_MEMORY_ERROR_SECTION , описывающая данные об ошибках памяти. Этот элемент используется только в том случае, если для элемента ErrorType задано значение WheaErrTypeMemory.

u.NmiError

Структура WHEA_NMI_ERROR_SECTION , описывающая немаскируемые данные об ошибках прерываний (NMI). Этот элемент используется только в том случае, если для элемента ErrorType задано значение WheaErrTypeNMI.

u.PciExpressError

Структура WHEA_PCIEXPRESS_ERROR_SECTION , описывающая данные об ошибках PCI Express (PCIe). Этот элемент используется, только если для элемента ErrorType задано значение WheaErrTypePCIExpress.

u.PciXBusError

Структура WHEA_PCIXBUS_ERROR_SECTION , описывающая данные об ошибках шины PCI или PCI-X. Этот элемент используется только в том случае, если для элемента ErrorType задано значение WheaErrTypePCIXBus.

u.PciXDeviceError

Структура WHEA_PCIXDEVICE_ERROR_SECTION , описывающая данные об ошибках устройств PCI или PCI-X. Этот элемент используется, только если для элемента ErrorType задано значение WheaErrTypePCIXDevice.

u.PmemError

RawDataFormat

WHEA_RAW_DATA_FORMAT типизированное значение, указывающее формат сведений об ошибках оборудования, содержащихся в буфере данных RawData.

RawDataOffset

Смещение (в байтах) от начала буфера данных RawData , где подключаемый модуль PSHED может добавлять дополнительные сведения об ошибках конкретной платформы в пакет ошибок оборудования. Объем дополнительных сведений, которые можно добавить в пакет ошибок оборудования, ограничивается общим размером пакета, указанным в элементе Size .

RawData[1]

Буфер данных переменной величины, содержащий необработанные сведения об ошибках оборудования из регистров состояния источника ошибок. Формат данных об ошибках оборудования определяется элементом RawDataFormat .

Если подключаемые модули драйвера ошибок оборудования (PSHED) для конкретной платформы выполняются в любой версии Windows, совместимой с WHEA, вы можете проверить версию WHEA_ERROR_PACKET, выполнив следующие действия.

Если элемент Signature для WHEA_ERROR_PACKET равен WHEA_ERROR_PACKET_V1_SIGNATURE, код выполняется в ранней версии Windows, а пакет ошибок форматируется в виде структуры WHEA_ERROR_PACKET_V1 .
Если элемент Signature для WHEA_ERROR_PACKET равен WHEA_ERROR_PACKET_V2_SIGNATURE, код выполняется в более поздней версии Windows, а пакет ошибок форматируется в виде WHEA_ERROR_PACKET_V2 структуры.

LLHEH передает структуру WHEA_ERROR_PACKET_V1 операционной системе, когда сообщает об ошибке оборудования. Этот пакет ошибок оборудования содержит необработанные данные об ошибках оборудования непосредственно из регистров состояния ошибок источника ошибок.

Структура WHEA_ERROR_PACKET_V1 описывает данные об ошибках, содержащиеся в разделе ошибки пакета ошибок оборудования записи об ошибке. Запись об ошибке содержит раздел ошибки пакета ошибок оборудования, только если элемент SectionType одной из WHEA_ERROR_RECORD_SECTION_DESCRIPTOR структур, описывающих разделы для этой записи ошибки, содержит WHEA_PACKET_SECTION_GUID.

Требования

Требование	Значение
Минимальная версия клиента	Поддерживается в Windows Server 2008 и Windows Vista с пакетом обновления 1 (SP1).
Верхняя часть	ntddk.h (включая Ntddk.h)