WHEA_PCIEXPRESS_ERROR_SECTION 结构 (ntddk.h)
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 设备的 PCI 命令和状态寄存器的内容。 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)
WHEA_PCIEXPRESS_COMMAND_STATUS联合内容的 ULONG 表示形式。
仅当设置了 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
总线上设备的设备编号。
Segment
包含设备的总线段数。
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) 错误节中包含的 错误数据。 仅当描述该错误记录的错误记录节的某个WHEA_ERROR_RECORD_SECTION_DESCRIPTOR结构的 SectionType 成员包含PCIEXPRESS_ERROR_SECTION_GUID时，错误记录才包含 PCIe 错误节。
要求
| 要求 | 值 |
|---|---|
| Header | ntddk.h (包括 Ntddk.h) |