structure WHEA_ERROR_PACKET_V1 (ntddk.h)

Article
08/07/2023

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érielle. Ce membre contient la valeur WHEA_ERROR_PACKET_V1_SIGNATURE.

Flags

Une union WHEA_ERROR_PACKET_FLAGS qui décrit la condition d’erreur.

Size

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

RawDataLength

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

Reserved1

Réservé pour le système.

Context

Réservé pour le système.

ErrorType

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

ErrorSeverity

Valeur de type WHEA_ERROR_SEVERITY 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 de type WHEA_ERROR_SOURCE_TYPE qui indique le type de source d’erreur qui a signalé l’erreur matérielle.

Reserved2

Réservé pour le système.

Version

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

Cpu

Réservé pour le 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 est utilisé uniquement 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 masquables (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 est défini sur WheaErrTypePCIExpress.

u.PciXBusError

Une structure WHEA_PCIXBUS_ERROR_SECTION qui décrit les données d’erreur du bus PCI ou PCI-X. Ce membre est utilisé uniquement 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 est utilisé uniquement lorsque le membre ErrorType est défini sur WheaErrTypePCIXDevice.

u.PmemError

RawDataFormat

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

RawDataOffset

Décalage, en octets, à partir du début de la mémoire tampon de données RawData où un plug-in PSHED peut ajouter des informations d’erreur supplémentaires spécifiques à la plateforme au paquet d’erreur matérielle. La quantité d’informations supplémentaires pouvant être ajoutées au paquet d’erreur matérielle 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 status 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 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 du 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 en tant que structure de WHEA_ERROR_PACKET_V1 .
Si le membre Signature du 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’erreur est mis en forme en tant que structure WHEA_ERROR_PACKET_V2 .

Un 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 provenant directement des registres d’erreur status 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 d’erreur matérielle d’un enregistrement d’erreur. Un enregistrement d’erreur contient une section d’erreur de paquet d’erreur matérielle uniquement si le membre SectionType de l’une des structures WHEA_ERROR_RECORD_SECTION_DESCRIPTOR qui décrivent les sections d’enregistrement d’erreurs pour cet enregistrement d’erreur contient WHEA_PACKET_SECTION_GUID.