WHEA_PCIEXPRESS_ERROR_SECTION Struktur (ntddk.h)
Die WHEA_PCIEXPRESS_ERROR_SECTION-Struktur beschreibt PCI Express (PCIe)-Fehlerdaten.
Syntax
typedef struct _WHEA_PCIEXPRESS_ERROR_SECTION {
WHEA_PCIEXPRESS_ERROR_SECTION_VALIDBITS ValidBits;
WHEA_PCIEXPRESS_DEVICE_TYPE PortType;
WHEA_PCIEXPRESS_VERSION Version;
WHEA_PCIEXPRESS_COMMAND_STATUS CommandStatus;
ULONG Reserved;
WHEA_PCIEXPRESS_DEVICE_ID DeviceId;
ULONGLONG DeviceSerialNumber;
WHEA_PCIEXPRESS_BRIDGE_CONTROL_STATUS BridgeControlStatus;
UCHAR ExpressCapability[60];
UCHAR AerInfo[96];
} WHEA_PCIEXPRESS_ERROR_SECTION, *PWHEA_PCIEXPRESS_ERROR_SECTION;
Angehörige
ValidBits
Eine WHEA_PCIEXPRESS_ERROR_SECTION_VALIDBITS Vereinigung, die angibt, welche Mitglieder dieser Struktur gültige Daten enthalten.
PortType
Der Gerätetyp oder Porttyp der PCIe-Komponente, bei der der Fehler aufgetreten ist. Mögliche Werte sind:
WheaPciExpressEndpoint
Ein PCIe-Endpunktgerät.
WheaPciExpressLegacyEndpoint
Ein älteres PCIe-Endpunktgerät.
WheaPciExpressRootPort
Ein Stammport eines PCIe-Stammkomplexes.
WheaPciExpressUpstreamSwitchPort
Ein vorgelagerter Port eines PCIe-Switches.
WheaPciExpressDownstreamSwitchPort
Ein nachgeschalteter Port eines PCIe-Switches.
WheaPciExpressToPciXBridge
Eine PCIe-zu-PCI- oder PCI-X-Brücke.
WheaPciXToExpressBridge
Eine PCI- oder PCI-X-zu-PCIe-Brücke.
WheaPciExpressRootComplexIntegratedEndpoint
Ein PCIe-Endpunktgerät, das in den Stammkomplex integriert ist.
WheaPciExpressRootComplexEventCollector
Ein PCIe-Stammereignissammler.
Dieses Element enthält nur gültige Daten, wenn das ValidBits.PortType Bit festgelegt ist.
Version
Eine WHEA_PCIEXPRESS_VERSION Union, die die Version der PCIe-Spezifikation enthält, die von der Hardwareplattform unterstützt wird. Die WHEA_PCIEXPRESS_VERSION Union ist wie folgt definiert:
typedef union _WHEA_PCIEXPRESS_VERSION {
struct {
UCHAR MinorVersion;
UCHAR MajorVersion;
USHORT Reserved;
};
ULONG AsULONG;
} WHEA_PCIEXPRESS_VERSION, *PWHEA_PCIEXPRESS_VERSION;
MinorVersion
Die Nebenversionsnummer.
MajorVersion
Die Hauptversionsnummer.
Reserviert
Reserviert für die Systemverwendung.
AsULONG
Eine ULONG-Darstellung des Inhalts der WHEA_PCIEXPRESS_VERSION Vereinigung.
Dieses Element enthält nur gültige Daten, wenn das ValidBits.Version Bit festgelegt ist.
CommandStatus
Eine WHEA_PCIEXPRESS_COMMAND_STATUS Vereinigung, die den Inhalt des PCI-Befehls und Statusregister des PCIe-Geräts enthält, auf dem der Fehler aufgetreten ist. Die WHEA_PCIEXPRESS_COMMAND_STATUS Union ist wie folgt definiert:
typedef union _WHEA_PCIEXPRESS_COMMAND_STATUS {
struct {
USHORT Command;
USHORT Status;
};
ULONG AsULONG;
} WHEA_PCIEXPRESS_COMMAND_STATUS, *PWHEA_PCIEXPRESS_COMMAND_STATUS;
Befehl
Der Inhalt des PCI-Befehlsregisters.
Status
Der Inhalt des PCI-Statusregisters.
AsULONG (CommandStatus)
Eine ULONG Darstellung des Inhalts der WHEA_PCIEXPRESS_COMMAND_STATUS Vereinigung.
Dieses Element enthält nur gültige Daten, wenn das ValidBits.CommandStatus Bit festgelegt ist.
Reserved
Reserviert für die Systemverwendung.
DeviceId
Eine WHEA_PCIEXPRESS_DEVICE_ID Struktur, die Daten enthält, die das PCIe-Gerät identifiziert, auf dem der Fehler aufgetreten ist. Die WHEA_PCIEXPRESS_DEVICE_ID Struktur wird wie folgt definiert:
typedef struct _WHEA_PCIEXPRESS_DEVICE_ID {
USHORT VendorID;
USHORT DeviceID;
ULONG ClassCode:24;
ULONG FunctionNumber:8;
ULONG DeviceNumber:8;
ULONG Segment:16;
ULONG PrimaryBusNumber:8;
ULONG SecondaryBusNumber:8;
ULONG Reserved1:3;
ULONG SlotNumber:13; ULONG Reserved2:8;
} WHEA_PCIEXPRESS_DEVICE_ID, *PWHEA_PCIEXPRESS_DEVICE_ID;
VendorID
Die Hersteller-ID des Geräts.
DeviceId
Die Geräte-ID des Geräts.
ClassCode
Der Klassencode des Geräts.
FunctionNumber
Die Funktionsnummer des Geräts im Bus.
DeviceNumber
Die Gerätenummer des Geräts im Bus.
Segment
Die Nummer des Bussegments, das das Gerät enthält.
PrimaryBusNumber
Die primäre Busnummer des Stammports/der Brücke oder die Gerätebusnummer.
SecondaryBusNumber
Die sekundäre Busnummer des Stammports/der Brücke.
Reserviert1
Reserviert für die Systemverwendung.
SlotNumber
Die Steckplatznummer, an der sich das Gerät im System befindet.
Reserviert2
Reserviert für die Systemverwendung.
Dieses Element enthält nur gültige Daten, wenn die ValidBits.DeviceId Bit festgelegt ist.
DeviceSerialNumber
Die Seriennummer des PCIe-Geräts, auf dem der Fehler aufgetreten ist.
Dieses Element enthält nur gültige Daten, wenn das ValidBits.DeviceSerialNumber Bit festgelegt ist.
BridgeControlStatus
Eine WHEA_PCIEXPRESS_BRIDGE_CONTROL_STATUS Vereinigung, die den Inhalt des PCI-Steuerelements und sekundären Statusregister des Brückengeräts enthält, in dem der Fehler aufgetreten ist. Die WHEA_PCIEXPRESS_BRIDGE_CONTROL_STATUS Union ist wie folgt definiert:
typedef union _WHEA_PCIEXPRESS_BRIDGE_CONTROL_STATUS {
struct {
USHORT BridgeSecondaryStatus;
USHORT BridgeControl;
};
ULONG AsULONG;
} WHEA_PCIEXPRESS_BRIDGE_CONTROL_STATUS, *PWHEA_PCIEXPRESS_BRIDGE_CONTROL_STATUS;
BridgeSecondaryStatus
Der Inhalt des sekundären Statusregisters des Brückengeräts.
BridgeControl
Der Inhalt des Steuerelementregisters des Brückengeräts.
AsULONG (BridgeControlStatus)
Eine ULONG-Darstellung des Inhalts der WHEA_PCIEXPRESS_BRIDGE_CONTROL_STATUS Vereinigung.
Dieses Element enthält nur gültige Daten, wenn das ValidBits.BridgeControlStatus Bit festgelegt ist.
ExpressCapability[60]
Ein Puffer, der eine PCI_EXPRESS_CAPABILITY Struktur enthält, die die PCIe-Funktionsstruktur für das Gerät beschreibt, auf dem der Fehler aufgetreten ist.
Dieses Element enthält nur gültige Daten, wenn das ValidBits.ExpressCapability Bit festgelegt ist.
AerInfo[96]
Ein Puffer, der eine PCI_EXPRESS_AER_CAPABILITY Struktur enthält, die die erweiterte PcIe-Fehlerberichterstattungsstruktur (ADVANCED Error Reporting, AER) für das Gerät beschreibt, auf dem der Fehler aufgetreten ist.
Dieses Element enthält nur gültige Daten, wenn das ValidBits.AerInfo Bit festgelegt ist.
Bemerkungen
Die WHEA_PCIEXPRESS_ERROR_SECTION Struktur beschreibt die Fehlerdaten, die in einem PCI Express (PCIe)-Fehlerabschnitt eines Fehlerdatensatzesenthalten sind. Ein Fehlerdatensatz enthält nur dann einen PCIe-Fehlerabschnitt, wenn das SectionType-Element eines der WHEA_ERROR_RECORD_SECTION_DESCRIPTOR Strukturen, die die Fehlerdatensatzabschnitte für diesen Fehlerdatensatz beschreiben, PCIEXPRESS_ERROR_SECTION_GUID enthält.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header- | ntddk.h (include Ntddk.h) |