WHEA_ERROR_PACKET_V1 Struktur (ntddk.h)

Artikel
02/07/2025

Die WHEA_ERROR_PACKET_V1 Struktur beschreibt die Hardwarefehlerdaten, die von einem Hardwarefehlerhandler auf niedriger Ebene (LLHEH) an das Betriebssystem übergeben werden.

Die WHEA_ERROR_PACKET_V1-Struktur wird in Windows Server 2008 und Windows Vista SP1 unterstützt.

Verwenden Sie für Windows 7 und höhere Versionen von Windows die WHEA_ERROR_PACKET_V2 Struktur.

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;
    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;

Angehörige

Signature

Die Signatur des Hardwarefehlerpakets. Dieses Element enthält den Wert WHEA_ERROR_PACKET_V1_SIGNATURE.

Flags

Eine WHEA_ERROR_PACKET_FLAGS Union, die die Fehlerbedingung beschreibt.

Size

Die Größe des Hardwarefehlerpakets in Bytes, einschließlich der Rohdaten.

RawDataLength

Die Länge der Daten, die im RawData Member enthalten sind, in Byte.

Reserved1

Reserviert für die Systemverwendung.

Context

Reserviert für die Systemverwendung.

ErrorType

Ein WHEA_ERROR_TYPE-typed-Wert, der den Typ der Hardwarekomponente angibt, die den Hardwarefehler gemeldet hat.

ErrorSeverity

Ein WHEA_ERROR_SEVERITY-typed-Wert, der den Schweregrad der Fehlerbedingung angibt.

ErrorSourceId

Der Bezeichner der Fehlerquelle, die den Hardwarefehler gemeldet hat.

ErrorSourceType

Ein WHEA_ERROR_SOURCE_TYPE-typed-Wert, der den Typ der Fehlerquelle angibt, die den Hardwarefehler gemeldet hat.

Reserved2

Reserviert für die Systemverwendung.

Version

Die Version der WHEA_ERROR_PACKET_V1-Struktur. Dieses Element enthält den Wert WHEA_ERROR_PKT_V1VERSION.

Cpu

Reserviert für die Systemverwendung.

u

Eine Vereinigung, die aus den folgenden Mitgliedern besteht:

u.ProcessorError

Eine WHEA_PROCESSOR_GENERIC_ERROR_SECTION Struktur, die Prozessorfehlerdaten beschreibt. Dieses Element wird nur verwendet, wenn das ErrorType Member auf WheaErrTypeProcessorfestgelegt ist.

u.MemoryError

Eine WHEA_MEMORY_ERROR_SECTION Struktur, die Speicherfehlerdaten beschreibt. Dieses Element wird nur verwendet, wenn das ErrorType Member auf WheaErrTypeMemoryfestgelegt ist.

u.NmiError

Eine WHEA_NMI_ERROR_SECTION Struktur, die nicht maskierbare Interrupt-Fehlerdaten (NMI) beschreibt. Dieses Element wird nur verwendet, wenn das ErrorType Member auf WheaErrTypeNMI-festgelegt ist.

u.PciExpressError

Eine WHEA_PCIEXPRESS_ERROR_SECTION Struktur, die PCI Express (PCIe)-Fehlerdaten beschreibt. Dieses Element wird nur verwendet, wenn das ErrorType Member auf WheaErrTypePCIExpressfestgelegt ist.

u.PciXBusError

Eine WHEA_PCIXBUS_ERROR_SECTION Struktur, die PCI- oder PCI-X Busfehlerdaten beschreibt. Dieses Element wird nur verwendet, wenn der ErrorType Member auf WheaErrTypePCIXBusfestgelegt ist.

u.PciXDeviceError

Eine WHEA_PCIXDEVICE_ERROR_SECTION Struktur, die PCI- oder PCI-X Gerätefehlerdaten beschreibt. Dieses Element wird nur verwendet, wenn das ErrorType Member auf WheaErrTypePCIXDevicefestgelegt ist.

u.PmemError

RawDataFormat

Ein WHEA_RAW_DATA_FORMAT-typed-Wert, der das Format der Hardwarefehlerinformationen angibt, die im RawData--Datenpuffer enthalten sind.

RawDataOffset

Ein Offset (in Byte) vom Anfang des RawData- Datenpuffers, in dem ein PSHED-Plug-In zusätzliche plattformspezifische Fehlerinformationen zum Hardwarefehlerpaket hinzufügen kann. Die Menge der zusätzlichen Informationen, die dem Hardwarefehlerpaket hinzugefügt werden können, ist durch die Gesamtgröße des Pakets begrenzt, wie im Size Member angegeben.

RawData[1]

Ein Datenpuffer mit variabler Größe, der die Unformatierten Hardwarefehlerinformationen aus den Statusregistern der Fehlerquelle enthält. Das Format der Hardwarefehlerdaten wird durch das RawDataFormat Member angegeben.

Bemerkungen

Die WHEA_ERROR_PACKET_V1 Struktur wird verwendet, um einen Hardwarefehler in Windows Server 2008 und Windows Vista SP1 zu melden.

Wenn Ihre plattformspezifischen Hardwarefehlertreiber (PSHED)-Plug-Ins auf einer beliebigen WHEA-kompatiblen Windows-Version ausgeführt, können Sie die Version von WHEA_ERROR_PACKET überprüfen, indem Sie die folgenden Schritte ausführen:

Wenn das Signature Member für die WHEA_ERROR_PACKET WHEA_ERROR_PACKET_V1_SIGNATURE entspricht, wird der Code in einer frühen Version von Windows ausgeführt, und das Fehlerpaket wird als WHEA_ERROR_PACKET_V1 Struktur formatiert.
Wenn das Signatur element für die WHEA_ERROR_PACKET WHEA_ERROR_PACKET_V2_SIGNATURE entspricht, wird der Code in einer späteren Windows-Version ausgeführt, und das Fehlerpaket wird als WHEA_ERROR_PACKET_V2 Struktur formatiert.

Eine LLHEH übergibt eine WHEA_ERROR_PACKET_V1 Struktur an das Betriebssystem, wenn ein Hardwarefehler gemeldet wird. Dieses Hardwarefehlerpaket enthält die rohen Hardwarefehlerdaten direkt aus den Fehlerstatusregistern der Fehlerquelle.

Die WHEA_ERROR_PACKET_V1-Struktur beschreibt die Fehlerdaten, die in einem Abschnitt mit Hardwarefehlerpaketfehlern eines Fehlerdatensatzesenthalten sind. Ein Fehlerdatensatz enthält nur dann einen Abschnitt mit einem Hardwarefehlerpaketfehler, wenn das SectionType-Element eines der WHEA_ERROR_RECORD_SECTION_DESCRIPTOR Strukturen, die die Fehlerdatensatzabschnitte für diesen Fehlerdatensatz beschreiben, WHEA_PACKET_SECTION_GUID enthält.