функция обратного вызова PSHED_PI_CLEAR_ERROR_RECORD (ntddk.h)
Функция обратного вызова ClearErrorRecord подключаемого модуля PSHED очищает указанную запись об ошибке из постоянного хранилища данных системы.
Синтаксис
PSHED_PI_CLEAR_ERROR_RECORD PshedPiClearErrorRecord;
NTSTATUS PshedPiClearErrorRecord(
[in, out, optional] PVOID PluginContext,
[in] ULONG Flags,
[in] ULONGLONG ErrorRecordId
)
{...}
Параметры
[in, out, optional] PluginContext
Указатель на область контекста, указанную в элементе Contextструктуры WHEA_PSHED_PLUGIN_REGISTRATION_PACKET , когда подключаемый модуль PSHED вызывал функцию PshedRegisterPlugin для регистрации в PSHED.
[in] Flags
Битовая комбинация or'ed флагов, которые влияют на операцию очистки. В настоящее время флаги не определены.
[in] ErrorRecordId
Идентификатор записи об ошибке, которая очищается из постоянного хранилища данных системы. Этот идентификатор следует сравнивать с элементом Header.RecordId каждой WHEA_ERROR_RECORD структуры, записанной в постоянное хранилище данных системы, чтобы определить запись ошибки, которую необходимо очистить.
Возвращаемое значение
Функция обратного вызова ClearErrorRecord подключаемого модуля PSHED возвращает один из следующих кодов NTSTATUS:
| Код возврата | Описание |
|---|---|
| STATUS_SUCCESS | Запись об ошибке успешно удалена из постоянного хранилища данных системы. |
| STATUS_UNSUCCESSFUL | Произошла ошибка. |
Комментарии
Подключаемый модуль PSHED, участвующий в сохраняемости записи об ошибках, задает callbacks.WriteErrorRecord, Элементы Callbacks.ReadErrorRecord и Callbacks.ClearErrorRecordструктуры WHEA_PSHED_PLUGIN_REGISTRATION_PACKET , указывающие на функции обратного вызова WriteErrorRecord, ReadErrorRecord и ClearErrorRecord , когда подключаемый модуль вызывает функцию PshedRegisterPlugin для регистрации в PSHED. Подключаемый модуль PSHED также должен установить флаг PshedFAErrorRecordPersistence в элементе FunctionalAreaMask структуры WHEA_PSHED_PLUGIN_REGISTRATION_PACKET.
Ядро Windows вызывает PSHED для очистки записи об ошибках из постоянного хранилища данных системы. Если подключаемый модуль PSHED зарегистрирован для участия в сохраняемости записей ошибок, PSHED вызывает функцию обратного вызова ClearErrorRecord подключаемого модуля PSHED для выполнения операции очистки. Механизм, используемый для очистки записи об ошибках из постоянного хранилища данных системы, зависит от платформы.
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Персональный компьютер |
| Верхняя часть | ntddk.h (включая Ntddk.h) |
| IRQL | IRQL = DISPATCH_LEVEL |