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

Artículo
08/07/2023

Una función de devolución de llamada ClearErrorRecord del complemento PSHED borra el registro de error especificado del almacenamiento de datos persistente del sistema.

Sintaxis

PSHED_PI_CLEAR_ERROR_RECORD PshedPiClearErrorRecord;

NTSTATUS PshedPiClearErrorRecord(
  [in, out, optional] PVOID PluginContext,
  [in]                ULONG Flags,
  [in]                ULONGLONG ErrorRecordId
)
{...}

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 con el PSHED.

[in] Flags

Combinación or'ed bit a bit de marcas que afectan a la operación clara. Actualmente no hay marcas definidas.

[in] ErrorRecordId

Identificador del registro de error que se va a borrar del almacenamiento de datos persistente del sistema. Este identificador debe compararse con el miembro Header.RecordId de cada estructura de WHEA_ERROR_RECORD que se ha escrito en el almacenamiento de datos persistente del sistema para identificar el registro de error que se va a borrar.

Valor devuelto

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

Código devuelto	Descripción
STATUS_SUCCESS	El registro de error se ha borrado correctamente del 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 apuntar a sus funciones de devolución de llamada 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 borrar un registro de error del almacenamiento de datos persistente del 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 ClearErrorRecord del complemento PSHED para realizar la operación clear. El mecanismo que se usa para borrar el registro de errores del almacenamiento de datos persistente del sistema es específico de la plataforma.