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
WHEA_PCIEXPRESS_VERSION聯集，其中包含硬體平臺所支援的PCIe規格版本。 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)
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
裝置的廠商標識碼。
DeviceId
裝置的裝置識別碼。
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 結構的緩衝區，描述發生錯誤的裝置 (AER) 擴充功能結構的 PCIe 進階錯誤報告。
只有當設定 ValidBits.AerInfo 位時，此成員才會包含有效的數據。
備註
WHEA_PCIEXPRESS_ERROR_SECTION結構描述錯誤記錄的PCI Express (PCIe) 錯誤區段中所包含的 錯誤數據。 只有在描述該錯誤記錄的錯誤記錄區段包含PCIEXPRESS_ERROR_SECTION_GUID之其中一個WHEA_ERROR_RECORD_SECTION_DESCRIPTOR結構的 SectionType 成員時，錯誤記錄才會包含 PCIe 錯誤區段。
規格需求
| 需求 | 值 |
|---|---|
| 標頭 | ntddk.h (包含 Ntddk.h) |