Export (0) Print
Expand All
Expand Minimize

WHEA_NOTIFICATION_DESCRIPTOR structure

The WHEA_NOTIFICATION_DESCRIPTOR structure describes the notification mechanism that is used by an error source.

Syntax


struct WHEA_NOTIFICATION_DESCRIPTOR {
  UCHAR                   Type;
  UCHAR                   Length;
  WHEA_NOTIFICATION_FLAGS Flags;
  union {
    struct {
      ULONG PollInterval;
    } Polled;
    struct {
      ULONG PollInterval;
      ULONG Vector;
      ULONG SwitchToPollingThreshold;
      ULONG SwitchToPollingWindow;
      ULONG ErrorThreshold;
      ULONG ErrorThresholdWindow;
    } Interrupt;
    struct {
      ULONG PollInterval;
      ULONG Vector;
      ULONG SwitchToPollingThreshold;
      ULONG SwitchToPollingWindow;
      ULONG ErrorThreshold;
      ULONG ErrorThresholdWindow;
    } LocalInterrupt;
    struct {
      ULONG PollInterval;
      ULONG Vector;
      ULONG SwitchToPollingThreshold;
      ULONG SwitchToPollingWindow;
      ULONG ErrorThreshold;
      ULONG ErrorThresholdWindow;
    } Sci;
    struct {
      ULONG PollInterval;
      ULONG Vector;
      ULONG SwitchToPollingThreshold;
      ULONG SwitchToPollingWindow;
      ULONG ErrorThreshold;
      ULONG ErrorThresholdWindow;
    } Nmi;
  } u;
};

Members

Type

The type of notification mechanism that is used by the error source. This can be one of the following possible values.

ValueMeaning
WHEA_NOTIFICATION_TYPE_EXTERNALINTERRUPT

The error source notifies the LLHEH for the error source by means of an external interrupt.

WHEA_NOTIFICATION_TYPE_LOCALINTERRUPT

The error source notifies the LLHEH for the error source by means of a local interrupt.

WHEA_NOTIFICATION_TYPE_NMI

The error source notifies the LLHEH for the error source by means of a nonmaskable interrupt (NMI).

WHEA_NOTIFICATION_TYPE_POLLED

The low-level hardware error handler (LLHEH)for the error source must periodically poll the error status registers to check for an error condition.

WHEA_NOTIFICATION_TYPE_SCI

The error source notifies the LLHEH for the error source by means of a service control interrupt (SCI).

 

Length

The size, in bytes, of the WHEA_NOTIFICATION_DESCRIPTOR structure.

Flags

A WHEA_NOTIFICATION_FLAGS union that indicates which of the members of the WHEA_NOTIFICATION_DESCRIPTOR structure can be written to by the operating system. The WHEA_NOTIFICATION_FLAGS union is defined as follows:


typedef union _WHEA_NOTIFICATION_FLAGS {
  struct {
    USHORT  PollIntervalRW:1;
    USHORT  SwitchToPollingThresholdRW:1;
    USHORT  SwitchToPollingWindowRW:1;
    USHORT  ErrorThresholdRW:1;
    USHORT  ErrorThresholdWindowRW:1;
    USHORT  Reserved:11;
  };
  USHORT  AsUSHORT;
} WHEA_NOTIFICATION_FLAGS, *PWHEA_NOTIFICATION_FLAGS

ValueMeaning
AsUSHORT

A USHORT representation of the contents of the WHEA_NOTIFICATION_FLAGS union.

ErrorThresholdRW

A single bit that indicates that the operating system can write to the u.xxx.ErrorThreshold members of the WHEA_NOTIFICATION_DESCRIPTOR structure.

ErrorThresholdWindowRW

A single bit that indicates that the operating system can write to the u.xxx.ErrorThresholdWindow members of the WHEA_NOTIFICATION_DESCRIPTOR structure.

PollIntervalRW

A single bit that indicates that the operating system can write to the u.xxx.PollInterval members of the WHEA_NOTIFICATION_DESCRIPTOR structure.

Reserved

Reserved for system use.

SwitchToPollingThresholdRW

A single bit that indicates that the operating system can write to the u.xxx.SwitchToPollingThreshold members of the WHEA_NOTIFICATION_DESCRIPTOR structure.

SwitchToPollingWindowRW

A single bit that indicates that the operating system can write to the u.xxx.SwitchToPollingWindow members of the WHEA_NOTIFICATION_DESCRIPTOR structure.

 

u

A union of structures that are specific to each different type of notification mechanism.

Polled

A structure that describes the notification mechanism when the Type member is set to WHEA_NOTIFICATION_TYPE_POLLED.

PollInterval

The interval, in milliseconds, that the LLHEH for the error source should poll the error status registers to check for an error condition.

Interrupt

A structure that describes the notification mechanism when the Type member is set to WHEA_NOTIFICATION_TYPE_EXTERNALINTERRUPT.

PollInterval

The interval, in milliseconds, that the LLHEH for the error source should poll the error status registers to check for an error condition if the error source is switched out of interrupt mode.

Vector

The interrupt vector for the error source.

SwitchToPollingThreshold

The number of errors that must occur within the time specified by the SwitchToPollingWindow member before the error source is switched to polling mode.

SwitchToPollingWindow

The window of time, in seconds, in which the number of errors specified by the SwitchToPollingThreshold member must occur before the error source is switched to polling mode.

ErrorThreshold

The number of errors that must occur within the time specified by the ErrorThresholdWindow member before an error from the error source is processed by the operating system.

ErrorThresholdWindow

The window of time, in seconds, in which the number of errors specified by the ErrorThreshold member must occur before an error from the error source is processed by the operating system.

LocalInterrupt

A structure that describes the notification mechanism when the Type member is set to WHEA_NOTIFICATION_TYPE_LOCALINTERRUPT.

PollInterval

The interval, in milliseconds, that the LLHEH for the error source should poll the error status registers to check for an error condition if the error source is switched out of interrupt mode.

Vector

The interrupt vector for the error source.

SwitchToPollingThreshold

The number of errors that must occur within the time specified by the SwitchToPollingWindow member before the error source is switched to polling mode.

SwitchToPollingWindow

The window of time, in seconds, in which the number of errors specified by the SwitchToPollingThreshold member must occur before the error source is switched to polling mode.

ErrorThreshold

The number of errors that must occur within the time specified by the ErrorThresholdWindow member before an error from the error source is processed by the operating system.

ErrorThresholdWindow

The window of time, in seconds, in which the number of errors specified by the ErrorThreshold member must occur before an error from the error source is processed by the operating system.

Sci

A structure that describes the notification mechanism when the Type member is set to WHEA_NOTIFICATION_TYPE_SCI.

PollInterval

The interval, in milliseconds, that the LLHEH for the error source should poll the error status registers to check for an error condition if the error source is switched out of interrupt mode.

Vector

The interrupt vector for the error source.

SwitchToPollingThreshold

The number of errors that must occur within the time specified by the SwitchToPollingWindow member before the error source is switched to polling mode.

SwitchToPollingWindow

The window of time, in seconds, in which the number of errors specified by the SwitchToPollingThreshold member must occur before the error source is switched to polling mode.

ErrorThreshold

The number of errors that must occur within the time specified by the ErrorThresholdWindow member before an error from the error source is processed by the operating system.

ErrorThresholdWindow

The window of time, in seconds, in which the number of errors specified by the ErrorThreshold member must occur before an error from the error source is processed by the operating system.

Nmi

A structure that describes the notification mechanism when the Type member is set to WHEA_NOTIFICATION_TYPE_NMI.

PollInterval

The interval, in milliseconds, that the LLHEH for the error source should poll the error status registers to check for an error condition if the error source is switched out of interrupt mode.

Vector

The interrupt vector for the error source.

SwitchToPollingThreshold

The number of errors that must occur within the time specified by the SwitchToPollingWindow member before the error source is switched to polling mode.

SwitchToPollingWindow

The window of time, in seconds, in which the number of errors specified by the SwitchToPollingThreshold member must occur before the error source is switched to polling mode.

ErrorThreshold

The number of errors that must occur within the time specified by the ErrorThresholdWindow member before an error from the error source is processed by the operating system.

ErrorThresholdWindow

The window of time, in seconds, in which the number of errors specified by the ErrorThreshold member must occur before an error from the error source is processed by the operating system.

Remarks

A WHEA_NOTIFICATION_DESCRIPTOR structure is contained within the WHEA_GENERIC_ERROR_DESCRIPTOR and WHEA_XPF_CMC_DESCRIPTOR structures.

Requirements

Version

Supported in Windows Server 2008, Windows Vista SP1, and later versions of Windows.

Header

Ntddk.h (include Ntddk.h)

See also

WHEA_GENERIC_ERROR_DESCRIPTOR
WHEA_XPF_CMC_DESCRIPTOR

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft