WHEA_ERROR_SOURCE_DESCRIPTOR structure (ntddk.h)

Article
02/29/2024

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 de type WHEA_ERROR_SOURCE_TYPE qui spécifie le type de la source d’erreur.

State

Valeur de type WHEA_ERROR_SOURCE_STATE qui spécifie l’état de la source d’erreur.

MaxRawDataLength

Nombre maximal d’octets de données brutes incluses dans un paquet d’erreur matérielle signalé par cette source d’erreur. Ce nombre doit être suffisamment grand pour inclure des informations d’erreur supplémentaires spécifiques à la plateforme qui sont ajoutées au paquet d’erreur matérielle 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 les sections d’enregistrement d’erreur supplémentaires qui sont 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ù se trouve la source d’erreur.

PlatformErrorSourceId

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

Flags

Combinaison d’indicateurs OR’ed au niveau du bit 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 ne soit passé 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 dans le système qui sont du même type que celui spécifié dans le membre Type .

Info

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

Info.XpfMceDescriptor

Structure WHEA_XPF_MCE_DESCRIPTOR qui décrit une case activée source d’erreur MCE (exception mce) d’une machine processeur x86 ou x64.

Info.XpfCmcDescriptor

Structure WHEA_XPF_CMC_DESCRIPTOR qui décrit une source d’erreur machine case activée (CMC) corrigée par processeur x86 ou x64.

Info.XpfNmiDescriptor

Structure WHEA_XPF_NMI_DESCRIPTOR qui décrit une source d’erreur d’interruption non masquable (NMI) du processeur x86 ou x64.

Info.IpfMcaDescriptor

Structure WHEA_IPF_MCA_DESCRIPTOR qui décrit une machine de processeur Itanium case activée une source d’erreur d’abandon (MCA).

Info.IpfCmcDescriptor

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

Info.IpfCpeDescriptor

Structure WHEA_IPF_CPE_DESCRIPTOR qui décrit une source d’erreur DPE (Correction de l’erreur de plateforme) du processeur Itanium.

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’erreurs dans le système en appelant les méthodes de la classe de fournisseur WMI WHEAErrorSourceMethods .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Pris en charge dans Windows Server 2008, Windows Vista SP1 et les versions ultérieures de Windows.
En-tête	ntddk.h (incluez Ntddk.h)