WHEA_ERROR_PACKET_V1-Struktur (ntddk.h)

Artikel
03/08/2023

Die WHEA_ERROR_PACKET_V1-Struktur beschreibt die Hardwarefehlerdaten, die von einem Low-Level-Hardwarefehlerhandler (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;

Member

Signature

Die Signatur des Hardwarefehlerpakets. Dieser Member 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 in Bytes, die im RawData-Element enthalten sind.

Reserved1

Ist für das System reserviert.

Context

Ist für das System reserviert.

ErrorType

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

ErrorSeverity

Ein WHEA_ERROR_SEVERITY typisierter Wert, der den Schweregrad der Fehlerbedingung angibt.

ErrorSourceId

Der Bezeichner der Fehlerquelle, die den Hardwarefehler gemeldet hat.

ErrorSourceType

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

Reserved2

Ist für das System reserviert.

Version

Die Version der WHEA_ERROR_PACKET_V1-Struktur. Dieser Member enthält den Wert WHEA_ERROR_PKT_V1VERSION.

Cpu

Ist für das System reserviert.

u

Eine Union, die aus den folgenden Membern besteht:

u.ProcessorError

Eine WHEA_PROCESSOR_GENERIC_ERROR_SECTION-Struktur , die Prozessorfehlerdaten beschreibt. Dieser Member wird nur verwendet, wenn das ErrorType-Element auf WheaErrTypeProcessor festgelegt ist.

u.MemoryError

Eine WHEA_MEMORY_ERROR_SECTION-Struktur , die Speicherfehlerdaten beschreibt. Dieser Member wird nur verwendet, wenn das ErrorType-Element auf WheaErrTypeMemory festgelegt ist.

u.NmiError

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

u.PciExpressError

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

u.PciXBusError

Eine WHEA_PCIXBUS_ERROR_SECTION-Struktur , die PCI- oder PCI-X-Busfehlerdaten beschreibt. Dieser Member wird nur verwendet, wenn das ErrorType-Element auf WheaErrTypePCIXBus festgelegt ist.

u.PciXDeviceError

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

u.PmemError

RawDataFormat

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

RawDataOffset

Ein Offset in Bytes vom Anfang des RawData-Datenpuffers , bei dem ein PSHED-Plug-In dem Hardwarefehlerpaket zusätzliche plattformspezifische Fehlerinformationen hinzufügen kann. Die Menge an zusätzlichen Informationen, die dem Hardwarefehlerpaket hinzugefügt werden können, wird durch die Gesamtgröße des Pakets beschränkt, wie im Member Größe angegeben.

RawData[1]

Ein Datenpuffer mit variabler Größe, der die rohen Hardwarefehlerinformationen aus den status Registern der Fehlerquelle enthält. Das Format der Hardwarefehlerdaten wird vom RawDataFormat-Element angegeben.

Hinweise

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

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

Wenn das Signature-Element für die WHEA_ERROR_PACKET gleich WHEA_ERROR_PACKET_V1_SIGNATURE ist, wird der Code unter einer frühen Version von Windows ausgeführt, und das Fehlerpaket wird als WHEA_ERROR_PACKET_V1-Struktur formatiert.
Wenn der Signature-Member für die WHEA_ERROR_PACKET gleich WHEA_ERROR_PACKET_V2_SIGNATURE ist, wird der Code unter einer höheren Version von Windows ausgeführt, und das Fehlerpaket wird als WHEA_ERROR_PACKET_V2-Struktur formatiert.

Ein 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 dem Fehler der Fehlerquelle status Registern.

Die WHEA_ERROR_PACKET_V1-Struktur beschreibt die Fehlerdaten, die in einem Hardwarefehlerpaketfehlerabschnitt eines Fehlerdatensatzes enthalten sind. Ein Fehlerdatensatz enthält nur dann einen Abschnitt "Hardwarefehlerpaketfehler", wenn der SectionType-Member einer der WHEA_ERROR_RECORD_SECTION_DESCRIPTOR Strukturen, die die Fehlerdatensatzabschnitte für diesen Fehlerdatensatz beschreiben, WHEA_PACKET_SECTION_GUID enthält.