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 处理器更正的平台错误 (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