WHEA_PCIEXPRESS_ERROR_SECTION 结构描述 PCI Express (PCIe) 错误数据。
语法
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;
成员
ValidBits
一个 WHEA_PCIEXPRESS_ERROR_SECTION_VALIDBITS 联合,指定此结构的成员包含有效数据。
PortType
发生错误的 PCIe 组件的设备类型或端口类型。 可能的值包括:
WheaPciExpressEndpoint
PCIe 终结点设备。
WheaPciExpressLegacyEndpoint
旧版 PCIe 终结点设备。
WheaPciExpressRootPort
PCIe 根复杂性的根端口。
WheaPciExpressUpstreamSwitchPort
PCIe 交换机的上游端口。
WheaPciExpressDownstreamSwitchPort
PCIe 交换机的下游端口。
WheaPciExpressToPciXBridge
PCIe 到 PCI 或 PCI-X 网桥。
WheaPciXToExpressBridge
PCI 或 PCI-X 到 PCIe 桥。
WheaPciExpressRootComplexIntegratedEndpoint
集成到根复杂性中的 PCIe 终结点设备。
WheaPciExpressRootComplexEventCollector
PCIe 根复杂事件收集器。
仅当设置了 ValidBits.PortType 位时,此成员才包含有效数据。
Version
包含硬件平台支持的 PCIe 规范版本的 WHEA_PCIEXPRESS_VERSION 联合。 WHEA_PCIEXPRESS_VERSION 联合的定义如下:
typedef union _WHEA_PCIEXPRESS_VERSION {
struct {
UCHAR MinorVersion;
UCHAR MajorVersion;
USHORT Reserved;
};
ULONG AsULONG;
} WHEA_PCIEXPRESS_VERSION, *PWHEA_PCIEXPRESS_VERSION;
MinorVersion
次要版本号。
MajorVersion
主要版本号。
保留
保留供系统使用。
AsULONG
WHEA_PCIEXPRESS_VERSION 联合内容的 ULONG 表示形式。
仅当设置了 ValidBits.Version 位时,此成员才包含有效数据。
CommandStatus
一个 WHEA_PCIEXPRESS_COMMAND_STATUS 联合,其中包含发生错误的 PCIe 设备的内容和状态寄存器。 WHEA_PCIEXPRESS_COMMAND_STATUS 联合的定义如下:
typedef union _WHEA_PCIEXPRESS_COMMAND_STATUS {
struct {
USHORT Command;
USHORT Status;
};
ULONG AsULONG;
} WHEA_PCIEXPRESS_COMMAND_STATUS, *PWHEA_PCIEXPRESS_COMMAND_STATUS;
命令
PCI 命令寄存器的内容。
地位
PCI 状态寄存器的内容。
AsULONG (CommandStatus)
ULONGWHEA_PCIEXPRESS_COMMAND_STATUS 联合的内容表示形式。
仅当设置了 ValidBits.CommandStatus 位时,此成员才包含有效数据。
Reserved
保留供系统使用。
DeviceId
一个 WHEA_PCIEXPRESS_DEVICE_ID 结构,其中包含标识发生错误的 PCIe 设备的数据。 WHEA_PCIEXPRESS_DEVICE_ID 结构的定义如下:
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
设备的供应商 ID。
DeviceId
设备的设备 ID。
ClassCode
设备的类代码。
FunctionNumber
总线上的设备的函数号。
DeviceNumber
总线上的设备的设备编号。
段
包含设备的总线段数。
PrimaryBusNumber
根端口/桥主总线号或设备总线号。
SecondaryBusNumber
根端口/桥次总线号。
Reserved1
保留供系统使用。
SlotNumber
设备位于系统中的槽号。
Reserved2
保留供系统使用。
仅当设置了 ValidBits.DeviceId 位时,此成员才包含有效数据。
DeviceSerialNumber
发生错误的 PCIe 设备的序列号。
仅当设置了 ValidBits.DeviceSerialNumber 位时,此成员才包含有效数据。
BridgeControlStatus
一个 WHEA_PCIEXPRESS_BRIDGE_CONTROL_STATUS 联合,其中包含发生错误的网桥设备的 PCI 控件和辅助状态寄存器的内容。 WHEA_PCIEXPRESS_BRIDGE_CONTROL_STATUS 联合的定义如下:
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
桥设备的辅助状态寄存器的内容。
BridgeControl
网桥设备的控制寄存器的内容。
AsULONG (BridgeControlStatus)
WHEA_PCIEXPRESS_BRIDGE_CONTROL_STATUS 联合的内容的 ULONG 表示形式。
仅当设置了 ValidBits.BridgeControlStatus 位时,此成员才包含有效数据。
ExpressCapability[60]
包含 PCI_EXPRESS_CAPABILITY 结构的缓冲区,该结构描述发生错误的设备的 PCIe 功能结构。
仅当设置了 ValidBits.ExpressCapability 位时,此成员才包含有效数据。
AerInfo[96]
包含 PCI_EXPRESS_AER_CAPABILITY 结构的缓冲区,该结构描述发生错误的设备的 PCIe 高级错误报告 (AER) 扩展功能结构。
仅当设置了 ValidBits.AerInfo 位时,此成员才包含有效数据。
言论
WHEA_PCIEXPRESS_ERROR_SECTION结构描述 错误记录的 PCI Express(PCIe)错误节中包含的错误数据。 仅当 SectionType 一个描述该错误记录的 WHEA_ERROR_RECORD_SECTION_DESCRIPTOR 结构的 WHEA_ERROR_RECORD_SECTION_DESCRIPTOR 结构的成员包含PCIEXPRESS_ERROR_SECTION_GUID时,错误记录才会包含 PCIe 错误节。
要求
| 要求 | 价值 |
|---|---|
| 标头 | ntddk.h (包括 Ntddk.h) |