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

此标志指示为错误源指定的设置将应用于系统中所有与 类型 成员中指定的相同类型的错误源。

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