Функция WheaFindErrorRecordSection (ntddk.h)
Функция WheaFindErrorRecordSection ищет указанный раздел ошибки архитектуры ошибок оборудования Windows (WHEA) в записи ошибки WHEA. Раздел записи об ошибке имеет формат структуры WHEA_ERROR_RECORD_SECTION_DESCRIPTOR .
Синтаксис
NTSTATUS WheaFindErrorRecordSection(
[in] PWHEA_ERROR_RECORD Record,
[in] const GUID *SectionType,
[out] PWHEA_ERROR_RECORD_SECTION_DESCRIPTOR *SectionDescriptor,
[out, optional] PVOID *SectionData
);
Параметры
[in] Record
Указатель на запись ошибки WHEA, отформатированную в виде WHEA_ERROR_RECORD структуры.
[in] SectionType
GUID, указывающий структуру WHEA_ERROR_RECORD_SECTION_DESCRIPTOR , которая должна находиться в указанной записи ошибки WHEA.
[out] SectionDescriptor
Адрес указателя WHEA_ERROR_RECORD_SECTION_DESCRIPTOR .
Если функция WheaFindErrorRecordSection находит указанную WHEA_ERROR_RECORD_SECTION_DESCRIPTOR структуру, функция задает для параметра SectionDescriptor адрес этой структуры в указанной записи ошибки WHEA.
[out, optional] SectionData
Адрес указателя PVOID.
Если функция WheaFindErrorRecordSection находит указанную WHEA_ERROR_RECORD_SECTION_DESCRIPTOR структуру, функция задает для параметра SectionData адрес данных об ошибках оборудования, связанных с этим дескрипторем, в указанной записи об ошибке WHEA.
Этот параметр является необязательным и должен иметь значение NULL , если указатель на данные об ошибках оборудования не требуется.
Возвращаемое значение
WheaFindErrorRecordSection возвращает один из следующих кодов NTSTATUS:
| Код возврата | Описание |
|---|---|
| STATUS_SUCCESS | Найдена указанная структура WHEA_ERROR_RECORD_SECTION_DESCRIPTOR . |
| STATUS_NOT_FOUND | Указанная структура WHEA_ERROR_RECORD_SECTION_DESCRIPTOR не найдена. |
| STATUS_INVALID_PARAMETER | Для параметров Record, SectionType или SectionDescriptor задано значение NULL, либо недопустимая запись об ошибке WHEA, указанная в параметре Record . |
Комментарии
Если функция WheaFindErrorRecordSection возвращает STATUS_SUCCESS, она располагает WHEA_ERROR_RECORD_SECTION_DESCRIPTOR структуру, указанную с помощью параметра Guid . WheaFindErrorRecordSection задает для параметра SectionDescriptor адрес расположенной WHEA_ERROR_RECORD_SECTION_DESCRIPTOR структуры.
Кроме того, если WheaFindErrorRecordSection возвращает STATUS_SUCCESS а вызывающий объект задает для параметра SectionData адрес переменной указателя PVOID, функция обновляет параметр адресом данных об ошибках оборудования, связанных с указанной структурой WHEA_ERROR_RECORD_SECTION_DESCRIPTOR .
Формат данных об ошибках оборудования зависит от элемента SectionTypeструктуры WHEA_ERROR_RECORD_SECTION_DESCRIPTOR , на который ссылается параметр SectionDescriptor . Например, если элемент SectionType имеет значение PROCESSOR_GENERIC_ERROR_SECTION_GUID, данные об ошибках оборудования форматируются в виде структуры WHEA_PROCESSOR_GENERIC_ERROR_SECTION .
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Поддерживается в Windows 7 и более поздних версиях Windows. |
| Целевая платформа | Персональный компьютер |
| Верхняя часть | ntddk.h (включая Ntddk.h) |
| IRQL | IRQL <=DISPATCH_LEVEL |