структура WHEA_NOTIFICATION_DESCRIPTOR (ntddk.h)

Статья
02/07/2025

Структура WHEA_NOTIFICATION_DESCRIPTOR описывает механизм уведомлений, используемый источником ошибки.

Синтаксис

typedef 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;
    struct {
      ULONG PollInterval;
      ULONG Vector;
      ULONG SwitchToPollingThreshold;
      ULONG SwitchToPollingWindow;
      ULONG ErrorThreshold;
      ULONG ErrorThresholdWindow;
    } Sea;
    struct {
      ULONG PollInterval;
      ULONG Vector;
      ULONG SwitchToPollingThreshold;
      ULONG SwitchToPollingWindow;
      ULONG ErrorThreshold;
      ULONG ErrorThresholdWindow;
    } Sei;
    struct {
      ULONG PollInterval;
      ULONG Vector;
      ULONG SwitchToPollingThreshold;
      ULONG SwitchToPollingWindow;
      ULONG ErrorThreshold;
      ULONG ErrorThresholdWindow;
    } Gsiv;
  } u;
} WHEA_NOTIFICATION_DESCRIPTOR, *PWHEA_NOTIFICATION_DESCRIPTOR;

Члены

Type

Тип механизма уведомлений, используемого источником ошибки. Это может быть одно из следующих возможных значений.

Ценность	Значение
WHEA_NOTIFICATION_TYPE_EXTERNALINTERRUPT	Источник ошибок уведомляет LLHEH для источника ошибок с помощью внешнего прерывания.
WHEA_NOTIFICATION_TYPE_LOCALINTERRUPT	Источник ошибок уведомляет LLHEH для источника ошибок с помощью локального прерывания.
WHEA_NOTIFICATION_TYPE_NMI	Источник ошибок уведомляет LLHEH для источника ошибок с помощью немаскируемых прерываний (NMI).
WHEA_NOTIFICATION_TYPE_POLLED	Обработчик ошибок с низкоуровневым оборудованием (LLHEH)для источника ошибок должен периодически опрашивать регистры состояния ошибки, чтобы проверить состояние ошибки.
WHEA_NOTIFICATION_TYPE_SCI	Источник ошибок уведомляет LLHEH для источника ошибок с помощью прерывания управления службой (SCI).

Length

Размер структуры WHEA_NOTIFICATION_DESCRIPTOR в байтах.

Flags

Объединение WHEA_NOTIFICATION_FLAGS, указывающее, какие члены WHEA_NOTIFICATION_DESCRIPTOR структуры можно записать в операционную систему. Объединение WHEA_NOTIFICATION_FLAGS определяется следующим образом:

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

Ценность	Значение
AsUSHORT	Представление USHORT содержимого объединения WHEA_NOTIFICATION_FLAGS.
ErrorThresholdRW	Один бит, указывающий, что операционная система может записывать данные в u.xxx. ErrorThreshold члены структуры WHEA_NOTIFICATION_DESCRIPTOR.
ErrorThresholdWindowRW	Один бит, указывающий, что операционная система может записывать данные в u.xxx. ErrorThresholdWindow члены структуры WHEA_NOTIFICATION_DESCRIPTOR.
PollIntervalRW	Один бит, указывающий, что операционная система может записывать данные в u.xxx. PollInterval члены структуры WHEA_NOTIFICATION_DESCRIPTOR.
зарезервированные	Зарезервировано для использования системы.
SwitchToPollingThresholdRW	Один бит, указывающий, что операционная система может записывать данные в u.xxx. SwitchToPollingThreshold члены структуры WHEA_NOTIFICATION_DESCRIPTOR.
SwitchToPollingWindowRW	Один бит, указывающий, что операционная система может записывать данные в u.xxx. SwitchToPollingWindow члены структуры WHEA_NOTIFICATION_DESCRIPTOR.

u

Объединение структур, относящихся к каждому типу механизма уведомлений.

u.Polled

Структура, описывающая механизм уведомлений, когда для элемента типа задано значение WHEA_NOTIFICATION_TYPE_POLLED.

u.Polled.PollInterval

Интервал в миллисекундах, который LLHEH для источника ошибок должен опрашивать регистры состояния ошибки, чтобы проверить состояние ошибки.

u.Interrupt

Структура, описывающая механизм уведомлений, когда для элемента типа задано значение WHEA_NOTIFICATION_TYPE_EXTERNALINTERRUPT.

u.Interrupt.PollInterval

Интервал в миллисекундах, который LLHEH для источника ошибок должен опрашивать регистры состояния ошибки, чтобы проверить состояние ошибки, если источник ошибок переключится из режима прерывания.

u.Interrupt.Vector

Вектор прерывания для источника ошибок.

u.Interrupt.SwitchToPollingThreshold

Количество ошибок, которые должны возникать в течение времени, указанного элементом SwitchToPollingWindow, прежде чем источник ошибок переключится в режим опроса.

u.Interrupt.SwitchToPollingWindow

Период времени в секундах, в котором количество ошибок, указанных элементом SwitchToPollingThreshold, должен возникать до перехода источника ошибок в режим опроса.

u.Interrupt.ErrorThreshold

Количество ошибок, которые должны возникать в течение времени, указанного элементом ErrorThresholdWindow, прежде чем ошибка из источника ошибок обрабатывается операционной системой.

u.Interrupt.ErrorThresholdWindow

Период времени в секундах, в котором количество ошибок, указанных элементом ErrorThreshold, должен возникать перед обработкой ошибки из источника ошибок операционной системой.

u.LocalInterrupt

Структура, описывающая механизм уведомлений, когда для элемента типа задано значение WHEA_NOTIFICATION_TYPE_LOCALINTERRUPT.

u.LocalInterrupt.PollInterval

u.LocalInterrupt.Vector

Вектор прерывания для источника ошибок.

u.LocalInterrupt.SwitchToPollingThreshold

u.LocalInterrupt.SwitchToPollingWindow

u.LocalInterrupt.ErrorThreshold

u.LocalInterrupt.ErrorThresholdWindow

u.Sci

Структура, описывающая механизм уведомлений, когда для элемента типа задано значение WHEA_NOTIFICATION_TYPE_SCI.

u.Sci.PollInterval

u.Sci.Vector

Вектор прерывания для источника ошибок.

u.Sci.SwitchToPollingThreshold

u.Sci.SwitchToPollingWindow

u.Sci.ErrorThreshold

u.Sci.ErrorThresholdWindow

u.Nmi

Структура, описывающая механизм уведомлений, когда для элемента типа задано значение WHEA_NOTIFICATION_TYPE_NMI.

u.Nmi.PollInterval

u.Nmi.Vector

Вектор прерывания для источника ошибок.

u.Nmi.SwitchToPollingThreshold

u.Nmi.SwitchToPollingWindow

u.Nmi.ErrorThreshold

u.Nmi.ErrorThresholdWindow

u.Sea

u.Sea.PollInterval

u.Sea.Vector

u.Sea.SwitchToPollingThreshold

u.Sea.SwitchToPollingWindow

u.Sea.ErrorThreshold

u.Sea.ErrorThresholdWindow

u.Sei

u.Sei.PollInterval

u.Sei.Vector

u.Sei.SwitchToPollingThreshold

u.Sei.SwitchToPollingWindow

u.Sei.ErrorThreshold

u.Sei.ErrorThresholdWindow

u.Gsiv

u.Gsiv.PollInterval

u.Gsiv.Vector

u.Gsiv.SwitchToPollingThreshold

u.Gsiv.SwitchToPollingWindow

u.Gsiv.ErrorThreshold

u.Gsiv.ErrorThresholdWindow

Замечания

Структура WHEA_NOTIFICATION_DESCRIPTOR содержится в WHEA_GENERIC_ERROR_DESCRIPTOR и WHEA_XPF_CMC_DESCRIPTOR структурах.

Требования

Требование	Ценность
заголовка	ntddk.h (include Ntddk.h)

См. также

WHEA_GENERIC_ERROR_DESCRIPTOR

WHEA_XPF_CMC_DESCRIPTOR

Поделиться через

структура WHEA_NOTIFICATION_DESCRIPTOR (ntddk.h)

Синтаксис

Члены

Замечания

Требования

См. также

Обратная связь

Дополнительные ресурсы