structure WHEA_ERROR_PACKET_V1 (ntddk.h)

Article
02/07/2025

La structure WHEA_ERROR_PACKET_V1 décrit les données d’erreur matérielle transmises au système d’exploitation par un gestionnaire d’erreurs matérielles de bas niveau (LLHEH).

La structure WHEA_ERROR_PACKET_V1 est prise en charge dans Windows Server 2008 et Windows Vista SP1.

Pour Windows 7 et versions ultérieures de Windows, utilisez la structure WHEA_ERROR_PACKET_V2.

Syntaxe

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;

Membres

Signature

Signature du paquet d’erreur matériel. Ce membre contient la valeur WHEA_ERROR_PACKET_V1_SIGNATURE.

Flags

Union WHEA_ERROR_PACKET_FLAGS qui décrit la condition d’erreur.

Size

Taille, en octets, du paquet d’erreur matériel, y compris les données brutes.

RawDataLength

Longueur, en octets, des données contenues dans le membre RawData.

Reserved1

Réservé à l’utilisation du système.

Context

Réservé à l’utilisation du système.

ErrorType

Valeur WHEA_ERROR_TYPE-typée qui indique le type de composant matériel qui a signalé l’erreur matérielle.

ErrorSeverity

Valeur WHEA_ERROR_SEVERITY-typée qui indique la gravité de la condition d’erreur.

ErrorSourceId

Identificateur de la source d’erreur qui a signalé l’erreur matérielle.

ErrorSourceType

Valeur WHEA_ERROR_SOURCE_TYPE-typée qui indique le type de source d’erreur qui a signalé l’erreur matérielle.

Reserved2

Réservé à l’utilisation du système.

Version

Version de la structure WHEA_ERROR_PACKET_V1. Ce membre contient la valeur WHEA_ERROR_PKT_V1VERSION.

Cpu

Réservé à l’utilisation du système.

u

Union composée des membres suivants :

u.ProcessorError

Structure WHEA_PROCESSOR_GENERIC_ERROR_SECTION qui décrit les données d’erreur du processeur. Ce membre est utilisé uniquement lorsque le membre ErrorType est défini sur WheaErrTypeProcessor.

u.MemoryError

Structure WHEA_MEMORY_ERROR_SECTION qui décrit les données d’erreur de mémoire. Ce membre n’est utilisé que lorsque le membre ErrorType est défini sur WheaErrTypeMemory.

u.NmiError

Structure WHEA_NMI_ERROR_SECTION qui décrit les données d’erreur d’interruption non masquée (NMI). Ce membre est utilisé uniquement lorsque le membre ErrorType est défini sur WheaErrTypeNMI.

u.PciExpressError

Structure WHEA_PCIEXPRESS_ERROR_SECTION qui décrit les données d’erreur PCI Express (PCIe). Ce membre est utilisé uniquement lorsque le membre ErrorType a la valeur WheaErrTypePCIExpress.

u.PciXBusError

Structure WHEA_PCIXBUS_ERROR_SECTION qui décrit les données d’erreur pci ou PCI-X bus. Ce membre n’est utilisé que lorsque le membre ErrorType est défini sur WheaErrTypePCIXBus.

u.PciXDeviceError

Structure WHEA_PCIXDEVICE_ERROR_SECTION qui décrit les données d’erreur d’appareil PCI ou PCI-X. Ce membre n’est utilisé que lorsque le membre ErrorType est défini sur WheaErrTypePCIXDevice.

u.PmemError

RawDataFormat

Valeur WHEA_RAW_DATA_FORMAT-typée qui indique le format des informations d’erreur matérielle contenues dans la mémoire tampon de données RawData.

RawDataOffset

Offset, en octets, à partir du début de la RawData mémoire tampon de données où un plug-in PSHED peut ajouter des informations d’erreur supplémentaires spécifiques à la plateforme au paquet d’erreurs matériel. La quantité d’informations supplémentaires qui peuvent être ajoutées au paquet d’erreurs matérielles est limitée par la taille totale du paquet, comme spécifié dans le membre Size.

RawData[1]

Mémoire tampon de données de taille variable qui contient les informations d’erreur matérielle brutes des registres d’état de la source d’erreur. Le format des données d’erreur matérielle est spécifié par le membre RawDataFormat.

Remarques

La structure WHEA_ERROR_PACKET_V1 est utilisée pour signaler une erreur matérielle dans Windows Server 2008 et Windows Vista SP1.

Si vos plug-ins PSHED (Platform-specific hardware error driver) s’exécutent sur n’importe quelle version de Windows compatible WHEA, vous pouvez inspecter la version de WHEA_ERROR_PACKET en procédant comme suit :

Si le membre signature pour l’WHEA_ERROR_PACKET est égal à WHEA_ERROR_PACKET_V1_SIGNATURE, le code s’exécute sur une version antérieure de Windows et le paquet d’erreur est mis en forme comme structure WHEA_ERROR_PACKET_V1.
Si le membre Signature pour l’WHEA_ERROR_PACKET est égal à WHEA_ERROR_PACKET_V2_SIGNATURE, le code s’exécute sur une version ultérieure de Windows et le paquet d’erreurs est mis en forme comme structure WHEA_ERROR_PACKET_V2.

LlHEH transmet une structure WHEA_ERROR_PACKET_V1 au système d’exploitation lorsqu’il signale une erreur matérielle. Ce paquet d’erreurs matérielles contient les données d’erreur matérielle brutes directement à partir des registres d’état d’erreur de la source d’erreur.

La structure WHEA_ERROR_PACKET_V1 décrit les données d’erreur contenues dans une section d’erreur de paquet d’erreur matérielle d’un enregistrement d’erreur . Un enregistrement d’erreur contient une section d’erreur de paquet d’erreurs matérielle uniquement si le SectionType membre de l’une des structures WHEA_ERROR_RECORD_SECTION_DESCRIPTOR qui décrivent les sections d’enregistrement d’erreur pour cet enregistrement d’erreur contient WHEA_PACKET_SECTION_GUID.