Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Функция обратного вызова 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 |