функция обратного вызова PSHED_PI_CLEAR_ERROR_STATUS (ntddk.h)

Функция обратного вызова PSHED ClearErrorStatus очищает все регистры ошибок, характерных для конкретной платформы, для исправления состояния ошибки оборудования.

Синтаксис

PSHED_PI_CLEAR_ERROR_STATUS PshedPiClearErrorStatus;

NTSTATUS PshedPiClearErrorStatus(
  [in, out, optional] PVOID PluginContext,
  [in]                PWHEA_ERROR_SOURCE_DESCRIPTOR ErrorSource,
  [in]                ULONG BufferLength,
  [in]                PWHEA_ERROR_RECORD ErrorRecord
)
{...}

Параметры

[in, out, optional] PluginContext

Указатель на область контекста, указанную в элементе WHEA_PSHED_PLUGIN_REGISTRATION_PACKET контекста контексте, когда подключаемый модуль PSHED вызывает функцию PshedRegisterPlugin для регистрации в PSHED.

[in] ErrorSource

Указатель на структуру WHEA_ERROR_SOURCE_DESCRIPTOR, описывающую источник ошибок, сообщающий об ошибке оборудования.

[in] BufferLength

Размер буфера в байтах, на который указывает параметр ErrorRecord.

[in] ErrorRecord

Указатель на структуру WHEA_ERROR_RECORD, описывающую запись об ошибке. Запись об ошибке описывает исправленное условие ошибки оборудования, для которого очищаются регистры состояния ошибок для конкретной платформы.

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

Функция обратного вызова PSHED ClearErrorStatus возвращает один из следующих кодов NTSTATUS:

Возвращаемый код Описание
STATUS_SUCCESS Состояние ошибки для конкретной платформы успешно очищается для исправленного состояния ошибки оборудования.
STATUS_NOT_SUPPORTED Подключаемый модуль PSHED не поддерживает указанный источник ошибок.
STATUS_UNSUCCESSFUL Произошла ошибка.

Замечания

Подключаемый модуль PSHED, который участвует в получении сведений об ошибках, задает Callbacks.RetrieveErrorInfo, Callbacks.FinalizeErrorRecordи Callbacks.ClearErrorStatus членов структуры WHEA_PSHED_PLUGIN_REGISTRATION_PACKET наведите указатель на его RetrieveErrorInfo, FinalizeErrorRecordи Функции обратного вызова ClearErrorStatus при вызове функции обратного вызова PshedRegisterPlugin для регистрации в PSHED. Подключаемый модуль PSHED также должен задать флаг PshedFAErrorInfoRetrie val в элементе FunctionalAreaMask структуры WHEA_PSHED_PLUGIN_REGISTRATION_PACKET.

Для исправленных аппаратных ошибок ядро Windows вызывает PSHED для очистки состояния ошибки источника ошибки в качестве последнего шага обработки ошибки. Если подключаемый модуль PSHED зарегистрирован для участия в получении сведений об ошибках, PSHED вызывает функцию обратного вызова PSHED подключаемого модуля ClearErrorStatus, чтобы подключаемый модуль PSHED может очистить любые дополнительные регистры ошибок для конкретной платформы.

Требования

Требование Ценность
целевая платформа Настольный
заголовка ntddk.h (include Ntddk.h)
IRQL IRQL = DISPATCH_LEVEL

См. также

FinalizeErrorRecord

PshedRegisterPlugin

RetrieveErrorInfo

WHEA_ERROR_RECORD

WHEA_ERROR_SOURCE_DESCRIPTOR

WHEA_PSHED_PLUGIN_REGISTRATION_PACKET