WHEA_ERROR_SOURCE_DESCRIPTOR-Struktur (ntddk.h)
Die WHEA_ERROR_SOURCE_DESCRIPTOR-Struktur beschreibt eine Fehlerquelle.
Syntax
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;
Member
Length
Die Größe der WHEA_ERROR_SOURCE_DESCRIPTOR Struktur in Bytes.
Version
Die Versionsnummer der WHEA_ERROR_SOURCE_DESCRIPTOR-Struktur. Dieses Element enthält den Wert WHEA_ERROR_SOURCE_DESCRIPTOR_VERSION_10.
Type
Ein WHEA_ERROR_SOURCE_TYPE typisierter Wert, der den Typ der Fehlerquelle angibt.
State
Ein WHEA_ERROR_SOURCE_STATE typisierter Wert, der den Zustand der Fehlerquelle angibt.
MaxRawDataLength
Die maximale Anzahl von Bytes von Rohdaten, die in einem Hardwarefehlerpaket enthalten sind, das von dieser Fehlerquelle gemeldet wird. Diese Zahl muss groß genug sein, um zusätzliche plattformspezifische Fehlerinformationen zu enthalten, die dem Hardwarefehlerpaket vom PSHED oder einem PSHED-Plug-In hinzugefügt werden.
NumRecordsToPreallocate
Die Anzahl der Fehlerdatensätze, die für Hardwarefehler, die von dieser Fehlerquelle gemeldet werden, vorab zugeordnet werden sollen.
MaxSectionsPerRecord
Die maximale Anzahl von Fehlerdatensatzabschnitten, die in einem Fehlerdatensatz erforderlich sind, um einen Hardwarefehler zu beschreiben, der von dieser Fehlerquelle gemeldet wird. Diese Zahl muss groß genug sein, um alle zusätzlichen Fehlerdatensatzabschnitte einzuschließen, die dem Fehlerdatensatz durch das PSHED-Plug-In oder ein PSHED-Plug-In während der Verarbeitung des Fehlers hinzugefügt werden.
ErrorSourceId
Der Bezeichner der Fehlerquelle. Dieser Bezeichner ist nur auf dem System eindeutig, auf dem die Fehlerquelle vorhanden ist.
PlatformErrorSourceId
Der Bezeichner der Fehlerquelle, die von der Hardwareplattform aufgelistet wird. Dieser Bezeichner ist nur auf dem System eindeutig, auf dem die Fehlerquelle vorhanden ist.
Flags
Eine bitweise OR'ed-Kombination von Flags, die die Fehlerquelle beschreibt. Mögliche Flags sind:
WHEA_ERROR_SOURCE_FLAG_DEFAULTSOURCE
Dieses Flag gibt an, dass die Fehlerquelle eine Standardfehlerquelle für den Typ der Hardwareplattform ist, auf der sie vorhanden ist.
WHEA_ERROR_SOURCE_FLAG_FIRMWAREFIRST
Dieses Flag gibt an, dass die von dieser Fehlerquelle gemeldeten Fehler von der Firmware behandelt werden, bevor die Steuerung der Hardwarefehlerverarbeitung an das Betriebssystem übergeben wird.
WHEA_ERROR_SOURCE_FLAG_GLOBAL
Dieses Flag gibt an, dass die für die Fehlerquelle angegebenen Einstellungen auf alle Fehlerquellen im System angewendet werden sollen, die denselben Typ aufweisen wie im Type-Member angegeben.
Info
Eine Union von Deskriptorstrukturen, die für jeden verschiedenen Typ von Fehlerquelle spezifisch sind.
Info.XpfMceDescriptor
Eine WHEA_XPF_MCE_DESCRIPTOR-Struktur , die eine Fehlerquelle für x86- oder x64-Prozessorcomputer zur Überprüfung der Ausnahme (MCE) beschreibt.
Info.XpfCmcDescriptor
Eine WHEA_XPF_CMC_DESCRIPTOR-Struktur , die eine CMC-Fehlerquelle (x86- oder x64-Prozessor korrigierte Computerüberprüfung) beschreibt.
Info.XpfNmiDescriptor
Eine WHEA_XPF_NMI_DESCRIPTOR-Struktur , die eine Fehlerquelle eines nicht maskierbaren X86- oder x64-Prozessors (NMI) beschreibt.
Info.IpfMcaDescriptor
Eine WHEA_IPF_MCA_DESCRIPTOR-Struktur , die eine Fehlerquelle für die Überprüfung des Itanium-Prozessorcomputers (MCA) beschreibt.
Info.IpfCmcDescriptor
Eine WHEA_IPF_CMC_DESCRIPTOR-Struktur , die eine CmC-Fehlerquelle (Itanium-Prozessor korrigierte Computerüberprüfung) beschreibt.
Info.IpfCpeDescriptor
Eine WHEA_IPF_CPE_DESCRIPTOR-Struktur , die eine CPE-Fehlerquelle (Platform Error, Plattformfehler korrigiert) eines Itanium-Prozessors beschreibt.
Info.AerRootportDescriptor
Eine WHEA_AER_ROOTPORT_DESCRIPTOR-Struktur , die eine Fehlerquelle für den PCI Express-Stammport (PCIe) beschreibt.
Info.AerEndpointDescriptor
Eine WHEA_AER_ENDPOINT_DESCRIPTOR Struktur, die eine PCIe-Endpunktfehlerquelle beschreibt.
Info.AerBridgeDescriptor
Eine WHEA_AER_BRIDGE_DESCRIPTOR-Struktur , die eine PCIe-Bridgefehlerquelle beschreibt.
Info.GenErrDescriptor
Eine WHEA_GENERIC_ERROR_DESCRIPTOR-Struktur , die eine generische Fehlerquelle beschreibt.
Info.GenErrDescriptorV2
Eine WHEA_DEVICE_DRIVER_DESCRIPTOR_V2-Struktur .
Info.DeviceDriverDescriptor
Eine WHEA_DEVICE_DRIVER_DESCRIPTOR-Struktur .
Hinweise
Die WHEA_ERROR_SOURCE_DESCRIPTOR-Struktur beschreibt eine Fehlerquelle. Die WHEA_ERROR_SOURCE_DESCRIPTOR-Struktur wird auch verwendet, um eine Fehlerquelle zu konfigurieren.
Eine WHEA-Verwaltungsanwendung im Benutzermodus kann die Fehlerquellen im System steuern, indem sie die Methoden in der WMI-Anbieterklasse WHEAErrorSourceMethods aufruft .
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Unterstützt in Windows Server 2008, Windows Vista SP1 und höheren Versionen von Windows. |
| Kopfzeile | ntddk.h (include Ntddk.h) |
Weitere Informationen
WHEAErrorSourceMethods::D isableErrorSourceRtn
WHEAErrorSourceMethods::EnableErrorSourceRtn
WHEAErrorSourceMethods::GetAllErrorSourcesRtn
WHEAErrorSourceMethods::GetErrorSourceInfoRtn