structure WHEA_ERROR_SOURCE_DESCRIPTOR (ntddk.h)

Article
02/07/2025

La structure WHEA_ERROR_SOURCE_DESCRIPTOR décrit une source d’erreur.

Syntaxe

typedef struct _WHEA_ERROR_SOURCE_DESCRIPTOR {
  ULONG                   Length;
  ULONG                   Version;
  WHEA_ERROR_SOURCE_TYPE  Type;
  WHEA_ERROR_SOURCE_STATE State;
  ULONG                   MaxRawDataLength;
  ULONG                   NumRecordsToPreallocate;
  ULONG                   MaxSectionsPerRecord;
  ULONG                   ErrorSourceId;
  ULONG                   PlatformErrorSourceId;
  ULONG                   Flags;
  union {
    WHEA_XPF_MCE_DESCRIPTOR          XpfMceDescriptor;
    WHEA_XPF_CMC_DESCRIPTOR          XpfCmcDescriptor;
    WHEA_XPF_NMI_DESCRIPTOR          XpfNmiDescriptor;
    WHEA_IPF_MCA_DESCRIPTOR          IpfMcaDescriptor;
    WHEA_IPF_CMC_DESCRIPTOR          IpfCmcDescriptor;
    WHEA_IPF_CPE_DESCRIPTOR          IpfCpeDescriptor;
    WHEA_AER_ROOTPORT_DESCRIPTOR     AerRootportDescriptor;
    WHEA_AER_ENDPOINT_DESCRIPTOR     AerEndpointDescriptor;
    WHEA_AER_BRIDGE_DESCRIPTOR       AerBridgeDescriptor;
    WHEA_GENERIC_ERROR_DESCRIPTOR    GenErrDescriptor;
    WHEA_GENERIC_ERROR_DESCRIPTOR_V2 GenErrDescriptorV2;
    WHEA_DEVICE_DRIVER_DESCRIPTOR    DeviceDriverDescriptor;
  } Info;
} *PWHEA_ERROR_SOURCE_DESCRIPTOR, WHEA_ERROR_SOURCE_DESCRIPTOR;

Membres

Length

Taille, en octets, de la structure WHEA_ERROR_SOURCE_DESCRIPTOR.

Version

Numéro de version de la structure WHEA_ERROR_SOURCE_DESCRIPTOR. Ce membre contient la valeur WHEA_ERROR_SOURCE_DESCRIPTOR_VERSION_10.

Type

Valeur WHEA_ERROR_SOURCE_TYPE-typée qui spécifie le type de la source d’erreur.

State

Valeur WHEA_ERROR_SOURCE_STATE-typée qui spécifie l’état de la source d’erreur.

MaxRawDataLength

Nombre maximal d’octets de données brutes inclus dans un paquet d’erreurs matériel signalé par cette source d’erreur. Ce nombre doit être suffisamment volumineux pour inclure toutes les informations d’erreur supplémentaires spécifiques à la plateforme ajoutées au paquet d’erreur matériel par le PSHED ou par un plug-in PSHED.

NumRecordsToPreallocate

Nombre d’enregistrements d’erreurs qui doivent être pré-alloués pour les erreurs matérielles signalées par cette source d’erreur.

MaxSectionsPerRecord

Nombre maximal de sections d’enregistrement d’erreur requises dans un enregistrement d’erreur pour décrire une erreur matérielle signalée par cette source d’erreur. Ce nombre doit être suffisamment grand pour inclure toutes les sections d’enregistrement d’erreur supplémentaires ajoutées à l’enregistrement d’erreur par le PSHED ou par un plug-in PSHED pendant le traitement de l’erreur.

ErrorSourceId

Identificateur de la source d’erreur. Cet identificateur est unique uniquement sur le système où la source d’erreur existe.

PlatformErrorSourceId

Identificateur de la source d’erreur tel qu’énuméré par la plateforme matérielle. Cet identificateur est unique uniquement sur le système où la source d’erreur existe.

Flags

Combinaison or’ed au niveau du bit des indicateurs qui décrit la source d’erreur. Les indicateurs possibles sont les suivants :

WHEA_ERROR_SOURCE_FLAG_DEFAULTSOURCE

Cet indicateur indique que la source d’erreur est une source d’erreur par défaut pour le type de plateforme matérielle sur laquelle elle existe.

WHEA_ERROR_SOURCE_FLAG_FIRMWAREFIRST

Cet indicateur indique que les erreurs signalées par cette source d’erreur sont gérées par le microprogramme avant que le contrôle du traitement des erreurs matérielles soit transmis au système d’exploitation.

WHEA_ERROR_SOURCE_FLAG_GLOBAL

Cet indicateur indique que les paramètres spécifiés pour la source d’erreur doivent être appliqués à toutes les sources d’erreur du système qui sont du même type que celles spécifiées dans le membre Type.

Info

Union de structures de descripteur spécifiques à chaque type de source d’erreur différent.

Info.XpfMceDescriptor

Structure WHEA_XPF_MCE_DESCRIPTOR qui décrit une source d’erreur de vérification de machine de processeur x86 ou x64 (MCE).

Info.XpfCmcDescriptor

Structure WHEA_XPF_CMC_DESCRIPTOR qui décrit une source d’erreur de vérification de machine (CMC) corrigée par un processeur x86 ou x64.

Info.XpfNmiDescriptor

Structure WHEA_XPF_NMI_DESCRIPTOR qui décrit une source d’erreur d’interruption non masquée du processeur x86 ou x64.

Info.IpfMcaDescriptor

Structure WHEA_IPF_MCA_DESCRIPTOR qui décrit une source d’erreur d’abandon de la vérification de l’ordinateur du processeur Itanium (MCA).

Info.IpfCmcDescriptor

Structure WHEA_IPF_CMC_DESCRIPTOR qui décrit une source d’erreur de vérification de machine corrigée par le processeur Itanium (CMC).

Info.IpfCpeDescriptor

Structure WHEA_IPF_CPE_DESCRIPTOR qui décrit une source d’erreur d’erreur de plateforme corrigée par un processeur Itanium (CPE).

Info.AerRootportDescriptor

Structure WHEA_AER_ROOTPORT_DESCRIPTOR qui décrit une source d’erreur de port racine PCI Express (PCIe).

Info.AerEndpointDescriptor

Structure WHEA_AER_ENDPOINT_DESCRIPTOR qui décrit une source d’erreur de point de terminaison PCIe.

Info.AerBridgeDescriptor

Structure WHEA_AER_BRIDGE_DESCRIPTOR qui décrit une source d’erreur de pont PCIe.

Info.GenErrDescriptor

Structure WHEA_GENERIC_ERROR_DESCRIPTOR qui décrit une source d’erreur générique.

Info.GenErrDescriptorV2

Structure WHEA_DEVICE_DRIVER_DESCRIPTOR_V2.

Info.DeviceDriverDescriptor

Structure WHEA_DEVICE_DRIVER_DESCRIPTOR.

Remarques

La structure WHEA_ERROR_SOURCE_DESCRIPTOR décrit une source d’erreur. La structure WHEA_ERROR_SOURCE_DESCRIPTOR est également utilisée pour configurer une source d’erreur.

Une application de gestion WHEA en mode utilisateur peut contrôler les sources d’erreur dans le système en appelant les méthodes de l'WHEAErrorSourceMethods classe de fournisseur WMI.

Exigences

Exigence	Valeur
client minimum pris en charge	Pris en charge dans Windows Server 2008, Windows Vista SP1 et versions ultérieures de Windows.
d’en-tête	ntddk.h (include Ntddk.h)