WHEA_AER_ROOTPORT_DESCRIPTOR structure (ntddk.h)

Article
02/28/2023

The WHEA_AER_ROOTPORT_DESCRIPTOR structure describes a PCI Express (PCIe) root port error source.

Syntax

typedef struct _WHEA_AER_ROOTPORT_DESCRIPTOR {
  USHORT                        Type;
  BOOLEAN                       Enabled;
  UCHAR                         Reserved;
  ULONG                         BusNumber;
  WHEA_PCI_SLOT_NUMBER          Slot;
  USHORT                        DeviceControl;
  AER_ROOTPORT_DESCRIPTOR_FLAGS Flags;
  ULONG                         UncorrectableErrorMask;
  ULONG                         UncorrectableErrorSeverity;
  ULONG                         CorrectableErrorMask;
  ULONG                         AdvancedCapsAndControl;
  ULONG                         RootErrorCommand;
} WHEA_AER_ROOTPORT_DESCRIPTOR, *PWHEA_AER_ROOTPORT_DESCRIPTOR;

Members

Type

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

Enabled

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

Reserved

Reserved for system use.

BusNumber

The root port's bus number.

Slot

A WHEA_PCI_SLOT_NUMBER structure that describes the logical PCI slot where the root port is located in the system.

DeviceControl

The contents of the root port's Device Control register.

Flags

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

typedef union _AER_ROOTPORT_DESCRIPTOR_FLAGS {
  struct {
    USHORT  UncorrectableErrorMaskRW:1;
    USHORT  UncorrectableErrorSeverityRW:1;
    USHORT  CorrectableErrorMaskRW:1;
    USHORT  AdvancedCapsAndControlRW:1;
    USHORT  RootErrorCommandRW:1;
    USHORT  Reserved:11;
  };
  USHORT  AsUSHORT;
} AER_ROOTPORT_DESCRIPTOR_FLAGS, *PAER_ROOTPORT_DESCRIPTOR_FLAGS

UncorrectableErrorMaskRW

A single bit that indicates that the operating system can write to the UncorrectableErrorMask member of the WHEA_AER_ROOTPORT_DESCRIPTOR structure.

UncorrectableErrorSeverityRW

A single bit that indicates that the operating system can write to the UncorrectableErrorSeverity member of the WHEA_AER_ROOTPORT_DESCRIPTOR structure.

CorrectableErrorMaskRW

A single bit that indicates that the operating system can write to the CorrectableErrorMask member of the WHEA_AER_ROOTPORT_DESCRIPTOR structure.

AdvancedCapsAndControlRW

A single bit that indicates that the operating system can write to the AdvancedCapsAndControl member of the WHEA_AER_ROOTPORT_DESCRIPTOR structure.

RootErrorCommandRW

A single bit that indicates that the operating system can write to the RootErrorCommand member of the WHEA_AER_ROOTPORT_DESCRIPTOR structure.

Reserved

Reserved for system use.

AsUSHORT

A USHORT representation of the contents of the AER_ROOTPORT_DESCRIPTOR_FLAGS union.

UncorrectableErrorMask

The contents of the root port's Uncorrectable Error Mask register.

UncorrectableErrorSeverity

The contents of the root port's Uncorrectable Error Severity register.

CorrectableErrorMask

The contents of the root port's Correctable Error Mask register.

AdvancedCapsAndControl

The contents of the root port's Advanced Error Capabilities and Control register.

RootErrorCommand

The contents of the root port's Root Error Command register.

Remarks

A WHEA_AER_ROOTPORT_DESCRIPTOR structure is contained within the WHEA_ERROR_SOURCE_DESCRIPTOR structure.

Requirements

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