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
此标志指示为错误源指定的设置将应用于系统中所有与 类型 成员中指定的相同类型的错误源。
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 处理器更正的平台错误 (CPE) 错误源的 WHEA_IPF_CPE_DESCRIPTOR 结构。
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