WHEA_ERROR_SOURCE_DESCRIPTOR結構 (ntddk.h)
WHEA_ERROR_SOURCE_DESCRIPTOR結構描述錯誤來源。
語法
typedef struct _WHEA_ERROR_SOURCE_DESCRIPTOR {
ULONG Length;
ULONG Version;
WHEA_ERROR_SOURCE_TYPE Type;
WHEA_ERROR_SOURCE_STATE State;
ULONG MaxRawDataLength;
ULONG NumRecordsToPreallocate;
ULONG MaxSectionsPerRecord;
ULONG ErrorSourceId;
ULONG PlatformErrorSourceId;
ULONG Flags;
union {
WHEA_XPF_MCE_DESCRIPTOR XpfMceDescriptor;
WHEA_XPF_CMC_DESCRIPTOR XpfCmcDescriptor;
WHEA_XPF_NMI_DESCRIPTOR XpfNmiDescriptor;
WHEA_IPF_MCA_DESCRIPTOR IpfMcaDescriptor;
WHEA_IPF_CMC_DESCRIPTOR IpfCmcDescriptor;
WHEA_IPF_CPE_DESCRIPTOR IpfCpeDescriptor;
WHEA_AER_ROOTPORT_DESCRIPTOR AerRootportDescriptor;
WHEA_AER_ENDPOINT_DESCRIPTOR AerEndpointDescriptor;
WHEA_AER_BRIDGE_DESCRIPTOR AerBridgeDescriptor;
WHEA_GENERIC_ERROR_DESCRIPTOR GenErrDescriptor;
WHEA_GENERIC_ERROR_DESCRIPTOR_V2 GenErrDescriptorV2;
WHEA_DEVICE_DRIVER_DESCRIPTOR DeviceDriverDescriptor;
} Info;
} *PWHEA_ERROR_SOURCE_DESCRIPTOR, WHEA_ERROR_SOURCE_DESCRIPTOR;
成員
Length
WHEA_ERROR_SOURCE_DESCRIPTOR 結構的大小，以位元組為單位。
Version
WHEA_ERROR_SOURCE_DESCRIPTOR 結構的版本號碼。 這個成員包含值WHEA_ERROR_SOURCE_DESCRIPTOR_VERSION_10。
Type
指定錯誤來源類型的 WHEA_ERROR_SOURCE_TYPE型別值。
State
指定錯誤來源狀態 的WHEA_ERROR_SOURCE_STATE型別值。
MaxRawDataLength
這個錯誤來源所報告的硬體錯誤封包中包含的原始數據位元組數目上限。 此數目必須夠大，才能包含 PSHED 或 PSHED 外掛程式新增至硬體錯誤封包的任何其他平臺特定錯誤資訊。
NumRecordsToPreallocate
應該針對此錯誤來源所報告的硬體錯誤預先配置的錯誤記錄數目。
MaxSectionsPerRecord
錯誤記錄中所需的錯誤記錄區段數目上限，以描述此錯誤來源所報告的硬體錯誤。 此數目必須夠大，才能在處理錯誤期間包含 PSHED 或 PSHED 外掛程式新增至錯誤記錄的任何其他錯誤記錄區段。
ErrorSourceId
錯誤來源的識別碼。 這個標識碼只有在錯誤來源存在系統上是唯一的。
PlatformErrorSourceId
硬體平臺列舉的錯誤來源標識碼。 這個標識碼只有在錯誤來源存在系統上是唯一的。
Flags
描述錯誤來源之旗標的位元組 OR 組合。 可能的旗標包括：
WHEA_ERROR_SOURCE_FLAG_DEFAULTSOURCE
此旗標表示錯誤來源是存在之硬體平台類型的預設錯誤來源。
WHEA_ERROR_SOURCE_FLAG_FIRMWAREFIRST
此旗標表示在將硬體錯誤處理控制傳遞給操作系統之前，韌體會先處理此錯誤來源所報告的錯誤。
WHEA_ERROR_SOURCE_FLAG_GLOBAL
此旗標表示針對錯誤來源指定的設定會套用至系統中所有與 Type 成員中指定的類型相同的錯誤來源。
Info
描述項結構的聯集，其專屬於每種不同類型的錯誤來源。
Info.XpfMceDescriptor
描述 x86 或 x64 處理器電腦檢查例外狀況 (MCE) 錯誤來源的WHEA_XPF_MCE_DESCRIPTOR結構。
Info.XpfCmcDescriptor
描述 x86 或 x64 處理器更正機器檢查 (CMC) 錯誤來源的 WHEA_XPF_CMC_DESCRIPTOR 結構。
Info.XpfNmiDescriptor
描述 x86 或 x64 處理器不可遮罩中斷 (NMI) 錯誤來源的WHEA_XPF_NMI_DESCRIPTOR結構。
Info.IpfMcaDescriptor
描述Itanium處理器計算機檢查中止 (MCA) 錯誤來源的WHEA_IPF_MCA_DESCRIPTOR結構。
Info.IpfCmcDescriptor
描述Itanium處理器更正機器檢查 (CMC) 錯誤來源的WHEA_IPF_CMC_DESCRIPTOR結構。
Info.IpfCpeDescriptor
描述 Itanium 處理器已更正平台錯誤的 WHEA_IPF_CPE_DESCRIPTOR 結構， (CPE) 錯誤來源。
Info.AerRootportDescriptor
描述PCI Express (PCIe) 根埠錯誤來源的 WHEA_AER_ROOTPORT_DESCRIPTOR 結構。
Info.AerEndpointDescriptor
描述 PCIe 端點錯誤來源 的WHEA_AER_ENDPOINT_DESCRIPTOR 結構。
Info.AerBridgeDescriptor
描述 PCIe 網橋錯誤來源 的WHEA_AER_BRIDGE_DESCRIPTOR 結構。
Info.GenErrDescriptor
描述泛型錯誤來源 的WHEA_GENERIC_ERROR_DESCRIPTOR 結構。
Info.GenErrDescriptorV2
WHEA_DEVICE_DRIVER_DESCRIPTOR_V2結構。
Info.DeviceDriverDescriptor
WHEA_DEVICE_DRIVER_DESCRIPTOR 結構。
備註
WHEA_ERROR_SOURCE_DESCRIPTOR結構描述錯誤來源。 WHEA_ERROR_SOURCE_DESCRIPTOR 結構也可用來設定錯誤來源。
使用者模式 WHEA 管理應用程式可以藉由呼叫 WHEAErrorSourceMethods WMI 提供者類別中的方法來控制系統中的錯誤來源。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows Server 2008、Windows Vista SP1 和更新版本的 Windows 支援。 |
| 標頭 | ntddk.h (包含 Ntddk.h) |
另請參閱
WHEAErrorSourceMethods：:D isableErrorSourceRtn
WHEAErrorSourceMethods：：EnableErrorSourceRtn
WHEAErrorSourceMethods：：GetAllErrorSourcesRtn
WHEAErrorSourceMethods：：GetErrorSourceInfoRtn