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

Статья
02/07/2025

Функция обратного вызова PSHED WriteErrorRecord записывает запись об ошибке в постоянное хранилище данных системы.

Синтаксис

PSHED_PI_WRITE_ERROR_RECORD PshedPiWriteErrorRecord;

NTSTATUS PshedPiWriteErrorRecord(
  [in, out, optional] PVOID PluginContext,
  [in]                ULONG Flags,
  [in]                ULONG RecordLength,
  [in]                PWHEA_ERROR_RECORD ErrorRecord
)
{...}

Параметры

[in, out, optional] PluginContext

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

[in] Flags

Битовая комбинация флагов OR, влияющих на операцию записи. Возможный флаг:

WHEA_WRITE_FLAG_DUMMY

Операция записи — это фиктивная операция записи. Данные не записываются в постоянное хранилище данных системы.

[in] RecordLength

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

[in] ErrorRecord

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

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

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

Возвращаемый код	Описание
STATUS_SUCCESS	Запись об ошибке была успешно записана в постоянное хранилище данных системы.
STATUS_UNSUCCESSFUL	Произошла ошибка.

Замечания

Подключаемый модуль PSHED, который участвует в сохраняемости записи ошибок, задает callbacks.WriteErrorRecord, Callbacks.ReadErrorRecord и Callbacks.ClearErrorRecord члены структуры WHEA_PSHED_PLUGIN_REGISTRATION_PACKET, чтобы указать на ее WriteErrorRecord, ReadErrorRecordи Функции обратного вызова ClearErrorRecord при вызове функции обратного вызова PshedRegisterPlu gin для регистрации в PSHED. Подключаемый модуль PSHED также должен задать флаг PshedFAErrorRecordPer sistence в элементе FunctionalAreaMask структуры WHEA_PSHED_PLUGIN_REGISTRATION_PACKET.

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