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

Artículo
03/05/2024

Una función de devolución de llamada WriteErrorRecord del complemento PSHED 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 de 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 ficticía. 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

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

Código devuelto	Descripción
STATUS_SUCCESS	El registro de error se escribió correctamente en el almacenamiento de datos persistente del sistema.
STATUS_UNSUCCESSFUL	Se produjo un error.

Comentarios

Un complemento PSHED que participa en la persistencia del registro de errores establece los miembros Callbacks.WriteErrorRecord, Callbacks.ReadErrorRecord y Callbacks.ClearErrorRecord de la estructura WHEA_PSHED_PLUGIN_REGISTRATION_PACKET para que apunten a sus funciones writeErrorRecord, ReadErrorRecord y ClearErrorRecord cuando el complemento llama a la función PshedRegisterPlugin para registrarse con 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 de otro modo para que se conserve el registro de error mientras se reinicia el sistema. Si se registra un complemento PSHED para participar en la persistencia del registro de errores, PSHED llama a la función de devolución de llamada WriteErrorRecord del complemento PSHED 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.