функция обратного вызова PSHED_PI_CLEAR_ERROR_STATUS (ntddk.h)
Функция обратного вызова ClearErrorStatus подключаемого модуля PSHED очищает все регистры состояния ошибок конкретной платформы для исправленного состояния ошибки оборудования.
Синтаксис
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
Указатель на область контекста, указанную в элементе ContextWHEA_PSHED_PLUGIN_REGISTRATION_PACKET структуры, когда подключаемый модуль PSHED вызвал функцию PshedRegisterPlugin для регистрации в PSHED.
[in] ErrorSource
Указатель на структуру WHEA_ERROR_SOURCE_DESCRIPTOR , описывающую источник ошибки, который сообщил об ошибке оборудования.
[in] BufferLength
Размер (в байтах) буфера, на который указывает параметр ErrorRecord .
[in] ErrorRecord
Указатель на структуру WHEA_ERROR_RECORD , описывающую запись об ошибке. Запись об ошибке описывает исправленное состояние ошибки оборудования, для которого очищаются регистры состояния ошибок для конкретной платформы.
Возвращаемое значение
Функция обратного вызова ClearErrorStatus подключаемого модуля PSHED возвращает один из следующих кодов 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 также должен установить флаг PshedFAErrorInfoRetrieval в элементе FunctionalAreaMask структуры WHEA_PSHED_PLUGIN_REGISTRATION_PACKET.
Для исправления условий ошибок оборудования ядро Windows вызывает PSHED для очистки состояния ошибки источника ошибки в качестве последнего шага обработки ошибки. Если подключаемый модуль PSHED зарегистрирован для участия в получении сведений об ошибках, PSHED вызывает функцию обратного вызова ClearErrorStatus подключаемого модуля PSHED, чтобы подключаемый модуль PSHED мог очистить любые дополнительные регистры состояния ошибок для конкретной платформы.
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Персональный компьютер |
| Верхняя часть | ntddk.h (включая Ntddk.h) |
| IRQL | IRQL = DISPATCH_LEVEL |