структура WHEA_ERROR_SOURCE_DESCRIPTOR (ntddk.h)
Структура 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, описывающая источник ошибки проверка компьютера с процессором 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, описывающая источник ошибок , исправленных процессором Itanium, проверка (CMC).
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 WHEAErrorSourceMethods .
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Поддерживается в Windows Server 2008, Windows Vista с пакетом обновления 1 (SP1) и более поздних версиях Windows. |
| Верхняя часть | ntddk.h (включая Ntddk.h) |
См. также раздел
WHEAErrorSourceMethods::D isableErrorSourceRtn
WHEAErrorSourceMethods::EnableErrorSourceRtn
WHEAErrorSourceMethods::GetAllErrorSourcesRtn
WHEAErrorSourceMethods::GetErrorSourceInfoRtn