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

Статья
07.02.2025

Структура 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

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

Info

Объединение структур дескриптора, относящихся к каждому типу источника ошибок.

Info.XpfMceDescriptor

Структура WHEA_XPF_MCE_DESCRIPTOR, описывающая источник ошибок проверки исключения (MCE) компьютера x86 или x64.

Info.XpfCmcDescriptor

Структура WHEA_XPF_CMC_DESCRIPTOR, описывающая источник ошибок проверки компьютера (CMC) x86 или x64.

Info.XpfNmiDescriptor

Структура WHEA_XPF_NMI_DESCRIPTOR, описывающая источник ошибок немаскируемых прерываний (NMI) процессора x86 или x64.

Info.IpfMcaDescriptor

Структура WHEA_IPF_MCA_DESCRIPTOR, описывающая источник ошибки прерывания проверки компьютера обработчика Itanium (MCA).

Info.IpfCmcDescriptor

Структура WHEA_IPF_CMC_DESCRIPTOR, описывающая источник ошибки проверки компьютера (CMC) процессора Itanium.

Info.IpfCpeDescriptor

Структура WHEA_IPF_CPE_DESCRIPTOR, описывающая исправленную ошибку платформы (CPE) процессора Itanium.

Info.AerRootportDescriptor

Структура WHEA_AER_ROOTPORT_DESCRIPTOR, описывающая источник ошибки корневого порта PCI Express (PCIe).

Info.AerEndpointDescriptor

Структура WHEA_AER_ENDPOINT_DESCRIPTOR, описывающая источник ошибок конечной точки PCIe.

Info.AerBridgeDescriptor

Структура WHEA_AER_BRIDGE_DESCRIPTOR, описывающая источник ошибки моста PCIe.

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 в пользовательском режиме может управлять источниками ошибок в системе, вызывая методы в классе поставщика WMI WHEAErrorSourceMethod s.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Поддерживается в Windows Server 2008, Windows Vista с пакетом обновления 1 (SP1) и более поздних версиях Windows.
заголовка	ntddk.h (include Ntddk.h)