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;
Angehörige
Length
Die Größe der WHEA_ERROR_SOURCE_DESCRIPTOR Struktur in Byte.
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-typed-Wert, der den Typ der Fehlerquelle angibt.
State
Ein WHEA_ERROR_SOURCE_STATE-typed-Wert, der den Status der Fehlerquelle angibt.
MaxRawDataLength
Die maximale Anzahl von Byte von Rohdaten, die in einem Hardwarefehlerpaket enthalten sind, das von dieser Fehlerquelle gemeldet wird. Diese Zahl muss groß genug sein, um alle zusätzlichen plattformspezifischen Fehlerinformationen einzuschließen, die dem Hardwarefehlerpaket von PSHED oder einem PSHED-Plug-In hinzugefügt werden.
NumRecordsToPreallocate
Die Anzahl der Fehlereinträge, die vorab für Hardwarefehler zugewiesen werden sollten, die von dieser Fehlerquelle gemeldet werden.
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 vom PSHED- oder einem 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, in dem die Fehlerquelle vorhanden ist.
PlatformErrorSourceId
Der Bezeichner der Fehlerquelle, die von der Hardwareplattform aufgezählt wird. Dieser Bezeichner ist nur auf dem System eindeutig, in dem die Fehlerquelle vorhanden ist.
Flags
Eine bitweise OR'ed-Kombination aus Flags, die die Fehlerquelle beschreibt. Mögliche Kennzeichen 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 den gleichen Typ aufweisen wie die im Element Typ.
Info
Eine Vereinigung von Deskriptorstrukturen, die für jede unterschiedliche Art von Fehlerquelle spezifisch sind.
Info.XpfMceDescriptor
Eine WHEA_XPF_MCE_DESCRIPTOR Struktur, die eine x86- oder x64-Prozessorcomputerüberprüfungs-Ausnahmequelle (MCE) beschreibt.
Info.XpfCmcDescriptor
Eine WHEA_XPF_CMC_DESCRIPTOR Struktur, die eine x86- oder x64-Prozessorfehlerquelle beschreibt, die die Computerprüfung (CMC) korrigiert.
Info.XpfNmiDescriptor
Eine WHEA_XPF_NMI_DESCRIPTOR Struktur, die eine x86- oder x64-Prozessorfehlerquelle beschreibt, die nicht maskierbaren Interrupt (NMI) beschreibt.
Info.IpfMcaDescriptor
Eine WHEA_IPF_MCA_DESCRIPTOR Struktur, die eine Itaniumprozessor-Computerüberprüfungs-Fehlerquelle (MCA) beschreibt.
Info.IpfCmcDescriptor
Eine WHEA_IPF_CMC_DESCRIPTOR Struktur, die einen Itanium-Prozessor beschreibt, der die Computerüberprüfung (CMC) fehlerquelle korrigiert.
Info.IpfCpeDescriptor
Eine WHEA_IPF_CPE_DESCRIPTOR Struktur, die einen Itanium-Prozessor beschreibt, der die Plattformfehlerquelle (CPE) beschreibt.
Info.AerRootportDescriptor
Eine WHEA_AER_ROOTPORT_DESCRIPTOR Struktur, die eine PCI Express (PCIe)-Stammportfehlerquelle 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-Brücke-Fehlerquelle 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.
Bemerkungen
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 WHEAErrorSourceMethods WMI-Anbieterklasse aufrufen.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Unterstützt in Windows Server 2008, Windows Vista SP1 und höheren Versionen von Windows. |
| Header- | ntddk.h (include Ntddk.h) |
Siehe auch
WHEAErrorSourceMethods::D isableErrorSourceRtn
WHEAErrorSourceMethods::EnableErrorSourceRtn
WHEAErrorSourceMethods::GetAllErrorSourcesRtn
WHEAErrorSourceMethods::GetErrorSourceInfoRtn