PSHED_PI_WRITE_ERROR_RECORD función de devolución de llamada (ntddk.h)

Un complemento PSHED WriteErrorRecord función de devolución de llamada escribe un registro de error en el almacenamiento de datos persistente del sistema.

Sintaxis

PSHED_PI_WRITE_ERROR_RECORD PshedPiWriteErrorRecord;

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

Parámetros

[in, out, optional] PluginContext

Puntero al área de contexto que se especificó en el miembro Context de la estructura WHEA_PSHED_PLUGIN_REGISTRATION_PACKET cuando el complemento PSHED llamó a la función pshedRegisterPlugin para registrarse en el PSHED.

[in] Flags

Combinación or'ed bit a bit de marcas que afectan a la operación de escritura. Una marca posible es:

WHEA_WRITE_FLAG_DUMMY

La operación de escritura es una operación de escritura ficticia. No se va a escribir ningún dato en el almacenamiento de datos persistente del sistema.

[in] RecordLength

Tamaño, en bytes, del registro de error al que apunta el parámetro ErrorRecord.

[in] ErrorRecord

Puntero a una estructura de WHEA_ERROR_RECORD que describe el registro de error que se está escribiendo en el almacenamiento de datos persistente del sistema.

Valor devuelto

Un complemento PSHED WriteErrorRecord función de devolución de llamada devuelve uno de los siguientes códigos NTSTATUS:

Observaciones

Un complemento PSHED que participa en la persistencia del registro de errores establece el Callbacks.WriteErrorRecord, Callbacks.ReadErrorRecord y Callbacks.ClearErrorRecord miembros de la estructura de WHEA_PSHED_PLUGIN_REGISTRATION_PACKET para que apunten a su WriteErrorRecord, ReadErrorRecordy ClearErrorRecord funciones de devolución de llamada cuando el complemento llama a la función PshedRegisterPlugin para registrarse en el PSHED. El complemento PSHED también debe establecer la marca PshedFAErrorRecordPersistence en el miembro FunctionalAreaMask de la estructura WHEA_PSHED_PLUGIN_REGISTRATION_PACKET.

El kernel de Windows llama al PSHED para escribir un registro de error en el almacenamiento de datos persistente del sistema siempre que exista una condición de error irrecuperable o irrecuperable para que el registro de errores se conserve mientras se reinicia el sistema. Si se registra un complemento PSHED para participar en la persistencia del registro de errores, PSHED llama al complemento PSHED WriteErrorRecord función de devolución de llamada para realizar la operación de escritura. El mecanismo que se usa para escribir el registro de errores en el almacenamiento de datos persistente del sistema es específico de la plataforma.

Requisitos

Consulte también

ClearErrorRecord

pshedRegisterPlugin

ReadErrorRecord

WHEA_ERROR_RECORD

WHEA_PSHED_PLUGIN_REGISTRATION_PACKET