struttura WHEA_ERROR_PACKET_V1 (ntddk.h)

Articolo
02/07/2025

La struttura WHEA_ERROR_PACKET_V1 descrive i dati degli errori hardware passati al sistema operativo da un gestore di errori hardware di basso livello (LLHEH).

La struttura WHEA_ERROR_PACKET_V1 è supportata in Windows Server 2008 e Windows Vista SP1.

Per Windows 7 e versioni successive di Windows, usare la struttura WHEA_ERROR_PACKET_V2.

Sintassi

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;

Membri

Signature

Firma del pacchetto di errore hardware. Questo membro contiene il valore WHEA_ERROR_PACKET_V1_SIGNATURE.

Flags

Unione WHEA_ERROR_PACKET_FLAGS che descrive la condizione di errore.

Size

Dimensioni, in byte, del pacchetto di errore hardware, inclusi i dati non elaborati.

RawDataLength

Lunghezza, in byte, dei dati contenuti nel membro RawData.

Reserved1

Riservato per l'uso del sistema.

Context

Riservato per l'uso del sistema.

ErrorType

Valore WHEA_ERROR_TYPEtipizzato che indica il tipo di componente hardware che ha segnalato l'errore hardware.

ErrorSeverity

Valore WHEA_ERROR_SEVERITY-typed che indica la gravità della condizione di errore.

ErrorSourceId

Identificatore dell'origine dell'errore che ha segnalato l'errore hardware.

ErrorSourceType

Valore WHEA_ERROR_SOURCE_TYPEtipizzato che indica il tipo di origine dell'errore che ha segnalato l'errore hardware.

Reserved2

Riservato per l'uso del sistema.

Version

Versione della struttura WHEA_ERROR_PACKET_V1. Questo membro contiene il valore WHEA_ERROR_PKT_V1VERSION.

Cpu

Riservato per l'uso del sistema.

u

Unione costituita dai membri seguenti:

u.ProcessorError

Struttura WHEA_PROCESSOR_GENERIC_ERROR_SECTION che descrive i dati di errore del processore. Questo membro viene utilizzato solo quando il membro ErrorType è impostato su WheaErrTypeProcessor.

u.MemoryError

Struttura WHEA_MEMORY_ERROR_SECTION che descrive i dati degli errori di memoria. Questo membro viene utilizzato solo quando il membro ErrorType è impostato su WheaErrTypeMemory.

u.NmiError

Struttura WHEA_NMI_ERROR_SECTION che descrive i dati di errore di interrupt non mascherabili . Questo membro viene utilizzato solo quando il membro ErrorType è impostato su WheaErrTypeNMI.

u.PciExpressError

Struttura WHEA_PCIEXPRESS_ERROR_SECTION che descrive i dati di errore di PCI Express (PCIe). Questo membro viene utilizzato solo quando il membro ErrorType è impostato su WheaErrTypePCIExpress.

u.PciXBusError

Struttura WHEA_PCIXBUS_ERROR_SECTION che descrive i dati di errore di PCI o PCI-X bus. Questo membro viene utilizzato solo quando il membro ErrorType è impostato su WheaErrTypePCIXBus.

u.PciXDeviceError

Struttura WHEA_PCIXDEVICE_ERROR_SECTION che descrive i dati di errore del dispositivo o PCI o PCI-X. Questo membro viene usato solo quando il membro ErrorType è impostato su WheaErrTypePCIXDevice.

u.PmemError

RawDataFormat

Valore WHEA_RAW_DATA_FORMAT-typed che indica il formato delle informazioni sull'errore hardware contenute nel buffer di dati RawData.

RawDataOffset

Offset, in byte, dall'inizio dell'RawData buffer di dati in cui un plug-in PSHED può aggiungere informazioni di errore supplementari specifiche della piattaforma al pacchetto di errore hardware. La quantità di informazioni supplementari che possono essere aggiunte al pacchetto di errore hardware è limitata dalle dimensioni totali del pacchetto, come specificato nel membro dimensioni.

RawData[1]

Buffer di dati di dimensioni variabili che contiene le informazioni sull'errore hardware non elaborato dai registri di stato dell'origine degli errori. Il formato dei dati di errore hardware viene specificato dal membro RawDataFormat.

Osservazioni

La struttura WHEA_ERROR_PACKET_V1 viene usata per segnalare un errore hardware in Windows Server 2008 e Windows Vista SP1.

Se i plug-in PSHED (Platform-Specific Hardware Error Driver) eseguiti in qualsiasi versione compatibile con WHEA di Windows, è possibile esaminare la versione di WHEA_ERROR_PACKET seguendo questa procedura:

Se il membro signature per il WHEA_ERROR_PACKET è uguale a WHEA_ERROR_PACKET_V1_SIGNATURE, il codice viene eseguito in una versione anticipata di Windows e il pacchetto di errore viene formattato come struttura WHEA_ERROR_PACKET_V1.
Se il membro firma per il WHEA_ERROR_PACKET è uguale a WHEA_ERROR_PACKET_V2_SIGNATURE, il codice viene eseguito in una versione successiva di Windows e il pacchetto di errore viene formattato come struttura WHEA_ERROR_PACKET_V2.

Un LLHEH passa una struttura WHEA_ERROR_PACKET_V1 al sistema operativo quando segnala un errore hardware. Questo pacchetto di errore hardware contiene i dati di errore hardware non elaborati diretti dai registri dello stato degli errori dell'origine degli errori.

La struttura WHEA_ERROR_PACKET_V1 descrive i dati di errore contenuti in una sezione di errore hardware del pacchetto di errore di un record di errore . Un record di errore contiene una sezione di errore hardware del pacchetto di errore solo se il membro sectionType di una delle strutture di WHEA_ERROR_RECORD_SECTION_DESCRIPTOR che descrivono le sezioni del record di errore per il record di errore contiene WHEA_PACKET_SECTION_GUID.