_WHEA_ERROR_PACKET_V1 structure

The WHEA_ERROR_PACKET_V1 structure describes the hardware error data that is passed to the operating system by a low-level hardware error handler (LLHEH).

Note The WHEA_ERROR_PACKET_V1 structure is supported in Windows Server 2008 and Windows Vista SP1.

Syntax

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;
  } u;
  WHEA_RAW_DATA_FORMAT    RawDataFormat;
  ULONG                   RawDataOffset;
  UCHAR                   RawData[1];
} WHEA_ERROR_PACKET_V1, *PWHEA_ERROR_PACKET_V1;

Members

Context

Reserved for system use.

Cpu

Reserved for system use.

ErrorSeverity

A WHEA_ERROR_SEVERITY-typed value that indicates the severity of the error condition.

ErrorSourceId

The identifier of the error source that reported the hardware error.

ErrorSourceType

A WHEA_ERROR_SOURCE_TYPE-typed value that indicates the type of error source that reported the hardware error.

ErrorType

A WHEA_ERROR_TYPE-typed value that indicates the type of hardware component that reported the hardware error.

Flags

A WHEA_ERROR_PACKET_FLAGS union that describes the error condition.

RawData

A variable-sized data buffer that contains the raw hardware error information from the error source's status registers. The format of the hardware error data is specified by the RawDataFormat member.

RawDataFormat

A WHEA_RAW_DATA_FORMAT-typed value that indicates the format of the hardware error information that is contained in the RawData data buffer.

RawDataLength

The length, in bytes, of the data that is contained in the RawData member.

RawDataOffset

An offset, in bytes, from the beginning of the RawData data buffer where a PSHED plug-in can add supplementary platform-specific error information to the hardware error packet. The amount of supplementary information that can be added to the hardware error packet is limited by the total size of the packet as specified in the Size member.

Reserved1

Reserved for system use.

Reserved2

Reserved for system use.

Signature

The signature of the hardware error packet. This member contains the value WHEA_ERROR_PACKET_V1_SIGNATURE.

Size

The size, in bytes, of the hardware error packet, including the raw data.

u

A union consisting of the following members:

Version

The version of the WHEA_ERROR_PACKET_V1 structure. This member contains the value WHEA_ERROR_PKT_V1VERSION.

Remarks

The WHEA_ERROR_PACKET_V1 structure is used to report a hardware error in Windows Server 2008 and Windows Vista SP1.

If your platform-specific hardware error driver (PSHED) plug-ins run on any WHEA-compatible Windows version, You can inspect the version of WHEA_ERROR_PACKET by following these steps:

  1. If the Signature member for the WHEA_ERROR_PACKET equals WHEA_ERROR_PACKET_V1, the code is running on an early version of Windows, and the error packet is formatted as a WHEA_ERROR_PACKET_V1 structure.

  2. If the Signature member for the WHEA_ERROR_PACKET equals WHEA_ERROR_PACKET_V2, the code is running on a later version of Windows, and the error packet is formatted as a WHEA_ERROR_PACKET_V2 structure.

An LLHEH passes a WHEA_ERROR_PACKET_V1 structure to the operating system when it reports a hardware error. This hardware error packet contains the raw hardware error data direct from the error source's error status registers.

The WHEA_ERROR_PACKET_V1 structure describes the error data that is contained in a hardware error packet error section of an error record. An error record contains a hardware error packet error section only if the SectionType member of one of the WHEA_ERROR_RECORD_SECTION_DESCRIPTOR structures that describe the error record sections for that error record contains WHEA_PACKET_SECTION_GUID.

Requirements

   
Windows version Supported in Windows Server 2008, Windows Vista SP1, and later versions of Windows. Supported in Windows Server 2008, Windows Vista SP1, and later versions of Windows.
Header ntddk.h (include Ntddk.h)

See Also

WHEA_ERROR_RECORD_SECTION_DESCRIPTOR

WHEA_MEMORY_ERROR_SECTION

WHEA_PCIXDEVICE_ERROR_SECTION

WHEA_PCIEXPRESS_ERROR_SECTION

WHEA_ERROR_PACKET_V2

WHEA_NMI_ERROR_SECTION

WHEA_ERROR_SEVERITY

WHEA_ERROR_TYPE

WHEA_ERROR_SOURCE_TYPE

WHEA_ERROR_PACKET_FLAGS

Platform-Specific Hardware Error Driver (PSHED) Plug-Ins

WHEA_PROCESSOR_GENERIC_ERROR_SECTION

WHEA_RAW_DATA_FORMAT

WHEA_PCIXBUS_ERROR_SECTION

Send comments about this topic to Microsoft