WHEA_ERROR_SOURCE_DESCRIPTOR struttura (ntddk.h)

Articolo
02/26/2024

La struttura WHEA_ERROR_SOURCE_DESCRIPTOR descrive un'origine di errore.

Sintassi

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;

Members

Length

Dimensioni, in byte, della struttura WHEA_ERROR_SOURCE_DESCRIPTOR.

Version

Numero di versione della struttura WHEA_ERROR_SOURCE_DESCRIPTOR. Questo membro contiene il valore WHEA_ERROR_SOURCE_DESCRIPTOR_VERSION_10.

Type

Valore WHEA_ERROR_SOURCE_TYPE tipizzato che specifica il tipo dell'origine errore.

State

Valore WHEA_ERROR_SOURCE_STATE tipizzato che specifica lo stato dell'origine errore.

MaxRawDataLength

Numero massimo di byte di dati non elaborati inclusi in un pacchetto di errore hardware segnalato da questa origine di errore. Questo numero deve essere abbastanza grande per includere eventuali informazioni di errore specifiche della piattaforma aggiuntive aggiunte al pacchetto di errore hardware dal PSHED o da un plug-in PSHED.

NumRecordsToPreallocate

Numero di record di errore che devono essere pre-allocati per gli errori hardware segnalati dall'origine dell'errore.

MaxSectionsPerRecord

Numero massimo di sezioni dei record di errore necessarie in un record di errore per descrivere un errore hardware segnalato da questa origine di errore. Questo numero deve essere sufficiente per includere eventuali sezioni aggiuntive del record di errore aggiunte al record di errore dal PSHED o da un plug-in PSHED durante l'elaborazione dell'errore.

ErrorSourceId

Identificatore dell'origine dell'errore. Questo identificatore è univoco solo nel sistema in cui esiste l'origine degli errori.

PlatformErrorSourceId

Identificatore dell'origine dell'errore come enumerato dalla piattaforma hardware. Questo identificatore è univoco solo nel sistema in cui esiste l'origine degli errori.

Flags

Combinazione bit per bit OR'ed di flag che descrive l'origine degli errori. I flag possibili sono:

WHEA_ERROR_SOURCE_FLAG_DEFAULTSOURCE

Questo flag indica che l'origine degli errori è un'origine di errore predefinita per il tipo di piattaforma hardware in cui esiste.

WHEA_ERROR_SOURCE_FLAG_FIRMWAREFIRST

Questo flag indica che gli errori segnalati da questa origine di errore vengono gestiti dal firmware prima del controllo dell'elaborazione degli errori hardware passati al sistema operativo.

WHEA_ERROR_SOURCE_FLAG_GLOBAL

Questo flag indica che le impostazioni specificate per l'origine degli errori devono essere applicate a tutte le origini di errore nel sistema che sono dello stesso tipo specificato nel membro Type .

Info

Unione di strutture descrittori specifiche per ogni tipo diverso di origine degli errori.

Info.XpfMceDescriptor

Struttura WHEA_XPF_MCE_DESCRIPTOR che descrive un'origine di errore del computer di controllo computer x86 o x64.

Info.XpfCmcDescriptor

Struttura WHEA_XPF_CMC_DESCRIPTOR che descrive un'origine di errore di controllo del computer (CMC) x86 o x64.

Info.XpfNmiDescriptor

Struttura WHEA_XPF_NMI_DESCRIPTOR che descrive un'origine di errore di interruzione nonmaskable del processore x86 o x64.

Info.IpfMcaDescriptor

Struttura WHEA_IPF_MCA_DESCRIPTOR che descrive un'origine di errore del computer del processore Itanium che controlla l'interruzione (MCA).

Info.IpfCmcDescriptor

Struttura WHEA_IPF_CMC_DESCRIPTOR che descrive un'origine di errore del processore Itanium corretta (CMC).

Info.IpfCpeDescriptor

Struttura WHEA_IPF_CPE_DESCRIPTOR che descrive un'origine di errore della piattaforma corretta dal processore Itanium .

Info.AerRootportDescriptor

Struttura WHEA_AER_ROOTPORT_DESCRIPTOR che descrive un'origine di errore della porta radice PCI Express (PCIe).

Info.AerEndpointDescriptor

Struttura WHEA_AER_ENDPOINT_DESCRIPTOR che descrive un'origine di errore dell'endpoint PCIe.

Info.AerBridgeDescriptor

Struttura WHEA_AER_BRIDGE_DESCRIPTOR che descrive un'origine di errore del bridge PCIe.

Info.GenErrDescriptor

Struttura WHEA_GENERIC_ERROR_DESCRIPTOR che descrive un'origine di errore generica.

Info.GenErrDescriptorV2

Struttura WHEA_DEVICE_DRIVER_DESCRIPTOR_V2 .

Info.DeviceDriverDescriptor

Struttura WHEA_DEVICE_DRIVER_DESCRIPTOR .

Commenti

La struttura WHEA_ERROR_SOURCE_DESCRIPTOR descrive un'origine di errore. La struttura WHEA_ERROR_SOURCE_DESCRIPTOR viene usata anche per configurare un'origine di errore.

Un'applicazione di gestione WHEA in modalità utente può controllare le origini degli errori nel sistema chiamando i metodi nella classe provider WMI WHEAErrorSourceMethods .

Requisiti

Requisito	Valore
Client minimo supportato	Supportato in Windows Server 2008, Windows Vista SP1 e versioni successive di Windows.
Intestazione	ntddk.h (include Ntddk.h)