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)

另请参阅

DisableErrorSource

EnableErrorSource

GetAllErrorSources

GetErrorSourceInfo

SetErrorSourceInfo

WHEAErrorSourceMethods::D isableErrorSourceRtn

WHEAErrorSourceMethods::EnableErrorSourceRtn

WHEAErrorSourceMethods::GetAllErrorSourcesRtn

WHEAErrorSourceMethods::GetErrorSourceInfoRtn

WHEAErrorSourceMethods::SetErrorSourceInfoRtn

WHEA_AER_BRIDGE_DESCRIPTOR

WHEA_AER_ENDPOINT_DESCRIPTOR

WHEA_AER_ROOTPORT_DESCRIPTOR

WHEA_ERROR_SOURCE_STATE

WHEA_ERROR_SOURCE_TYPE

WHEA_GENERIC_ERROR_DESCRIPTOR

WHEA_IPF_CMC_DESCRIPTOR

WHEA_IPF_CPE_DESCRIPTOR

WHEA_IPF_MCA_DESCRIPTOR

WHEA_XPF_CMC_DESCRIPTOR

WHEA_XPF_MCE_DESCRIPTOR

WHEA_XPF_NMI_DESCRIPTOR