Функция WheaFindNextErrorRecordSection (ntddk.h)

Функция WheaFindNextErrorRecordSection позволяет вызывающему объекту итеративно проверять разделы записи ошибок WHEA в записи об ошибке WHEA. Каждый раздел записи об ошибках форматируется как структура WHEA_ERROR_RECORD_SECTION_DESCRIPTOR.

Синтаксис

NTSTATUS WheaFindNextErrorRecordSection(
  [in]            PWHEA_ERROR_RECORD                    Record,
  [in, out]       ULONG                                 *Context,
  [out]           PWHEA_ERROR_RECORD_SECTION_DESCRIPTOR *SectionDescriptor,
  [out, optional] PVOID                                 *SectionData
);

Параметры

[in] Record

Указатель на запись об ошибке WHEA , форматируемую как структуру WHEA_ERROR_RECORD.

[in, out] Context

Указатель на переменную ULONG, которая поддерживает текущее состояние поиска.

Эта переменная должна быть инициализирована до нуля перед первым вызовом функции WheaFindNextErrorRecordSection.

[out] SectionDescriptor

Адрес указателя WHEA_ERROR_RECORD_SECTION_DESCRIPTOR.

Если функция WheaFindNextErrorRecordSection находит следующую WHEA_ERROR_RECORD_SECTION_DESCRIPTOR структуру в указанной записи ошибки WHEA, функция задает параметр SectionDescriptor адрес этой структуры в указанной записи ошибок WHEA.

[out, optional] SectionData

Адрес указателя PVOID.

Если функция WheaFindNextErrorRecordSection находит следующую WHEA_ERROR_RECORD_SECTION_DESCRIPTOR структуру в указанной записи об ошибке WHEA, функция задает параметр SectionData адресом данных об ошибках оборудования, связанных с этим дескриптором.

Этот параметр является необязательным и должен иметь значение NULL если указатель на данные раздела записи ошибок не требуется.

Возвращаемое значение

WheaFindNextErrorRecordSection возвращает один из следующих кодов NTSTATUS:

Замечания

Если параметр контекста имеет значение 0, WheaFindNextErrorRecordSection возвращает указатель на первую WHEA_ERROR_RECORD_SECTION_DESCRIPTOR структуру в записи об ошибке WHEA. WheaFindNextErrorRecordSection также обновит параметр Context с сведениями о состоянии, связанными с WHEA_ERROR_RECORD_SECTION_DESCRIPTOR, возвращенным с помощью параметра SectionDescriptor.

При последующих вызовах WheaFindNextErrorRecordSectionфункция возвращает следующую WHEA_ERROR_RECORD_SECTION_DESCRIPTOR структуру (если она доступна) в записи ошибок WHEA. Если функция находит следующую структуру WHEA_ERROR_RECORD_SECTION_DESCRIPTOR, она обновит параметр контекста. В противном случае функция вернет STATUS_NOT_FOUND.

Чтобы найти первую WHEA_ERROR_RECORD_SECTION_DESCRIPTOR в указанной записи ошибки WHEA , вызывающий объект должен задать переменную, адрес которого передается в параметре контекста контекста до вызова. После этого вызывающий объект не должен изменять значение переменной при поиске следующей WHEA_ERROR_RECORD_SECTION_DESCRIPTOR через последующие вызовы WheaFindNextErrorRecordSection.

Кроме того, если WheaFindNextErrorRecordSection возвращает 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.

Требования

См. также

запись об ошибке

WHEA_ERROR_PACKET

WHEA_ERROR_RECORD

WHEA_ERROR_RECORD_SECTION_DESCRIPTOR