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 设备的内容和状态寄存器。 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)

另请参阅

PCI_EXPRESS_AER_CAPABILITY

PCI_EXPRESS_CAPABILITY

WHEA_ERROR_PACKET

WHEA_ERROR_RECORD_SECTION_DESCRIPTOR

WHEA_PCIEXPRESS_ERROR_SECTION_VALIDBITS