WHEA_XPF_MCE_DESCRIPTOR structure (ntddk.h)

Article
02/22/2024

The WHEA_XPF_MCE_DESCRIPTOR structure describes a machine check exception (MCE) error source for an x86 or x64 processor.

Syntax

typedef struct _WHEA_XPF_MCE_DESCRIPTOR {
  USHORT                      Type;
  UCHAR                       Enabled;
  UCHAR                       NumberOfBanks;
  XPF_MCE_FLAGS               Flags;
  ULONGLONG                   MCG_Capability;
  ULONGLONG                   MCG_GlobalControl;
  WHEA_XPF_MC_BANK_DESCRIPTOR Banks[WHEA_MAX_MC_BANKS];
} WHEA_XPF_MCE_DESCRIPTOR, *PWHEA_XPF_MCE_DESCRIPTOR;

Members

Type

The type of error source descriptor. This member is always set to WHEA_ERROR_SOURCE_DESCRIPTOR_TYPE_XPFMCE.

Enabled

A Boolean value that indicates if the error source is enabled.

NumberOfBanks

The number of WHEA_XPF_MC_BANK_DESCRIPTOR structures contained in the Banks member.

Flags

An XPF_MCE_FLAGS union that indicates which of the members of the WHEA_XPF_MCE_DESCRIPTOR structure can be written to by the operating system. The XPF_MCE_FLAGS union is defined as follows:

typedef union _XPF_MCE_FLAGS {
  struct {
    UCHAR  MCG_CapabilityRW:1;
    UCHAR  MCG_GlobalControlRW:1;
    UCHAR  Reserved:30;
  };
  UCHAR  AsULONG;
} XPF_MCE_FLAGS, *PXPF_MCE_FLAGS;

MCG_CapabilityRW

A single bit that indicates that the operating system can write to the MCG_Capability member of the WHEA_XPF_MCE_DESCRIPTOR structure.

MCG_GlobalControlRW

A single bit that indicates that the operating system can write to the MCG_GlobalControl member of the WHEA_XPF_MCE_DESCRIPTOR structure.

Reserved

Reserved for system use.

AsULONG

A ULONG representation of the contents of the XPF_MCE_FLAGS union.

MCG_Capability

The contents of the processor's IA32_MCG_CAP model-specific register. This register contains capability information about the machine check architecture of the processor. For more information about the IA32_MCG_CAP register, see the Intel 64 and IA-32 Architectures Software Developer's Manual.

MCG_GlobalControl

The contents of the processor's IA32_MCG_CTL model-specific register. This register controls the reporting of machine check exceptions. For more information about the IA32_MCG_CTL register, see the Intel 64 and IA-32 Architectures Software Developer's Manual.

Banks[WHEA_MAX_MC_BANKS]

An array of WHEA_XPF_MC_BANK_DESCRIPTOR structures that describe the banks of machine check registers.

Remarks

A WHEA_XPF_MCE_DESCRIPTOR structure is contained within the WHEA_ERROR_SOURCE_DESCRIPTOR structure.

Requirements

Requirement	Value
Header	ntddk.h (include Ntddk.h)

Share via