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

Artículo
02/26/2024

La función de devolución de llamada ClearErrorStatus de un complemento PSHED borra los registros de estado de error específicos de la plataforma para una condición de error de hardware corregida.

Sintaxis

PSHED_PI_CLEAR_ERROR_STATUS PshedPiClearErrorStatus;

NTSTATUS PshedPiClearErrorStatus(
  [in, out, optional] PVOID PluginContext,
  [in]                PWHEA_ERROR_SOURCE_DESCRIPTOR ErrorSource,
  [in]                ULONG BufferLength,
  [in]                PWHEA_ERROR_RECORD ErrorRecord
)
{...}

Parámetros

[in, out, optional] PluginContext

Puntero al área de contexto especificada 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] ErrorSource

Puntero a una estructura de WHEA_ERROR_SOURCE_DESCRIPTOR que describe el origen del error que informó del error de hardware.

[in] BufferLength

Tamaño, en bytes, del búfer al que apunta el parámetro ErrorRecord .

[in] ErrorRecord

Puntero a una estructura WHEA_ERROR_RECORD que describe un registro de error. El registro de error describe la condición de error de hardware corregida para la que se borran los registros de estado de error específicos de la plataforma.

Valor devuelto

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

Código devuelto	Descripción
STATUS_SUCCESS	Los registros de estado de error específicos de la plataforma para la condición de error de hardware corregida se borraron correctamente.
STATUS_NOT_SUPPORTED	El complemento PSHED no admite el origen de error especificado.
STATUS_UNSUCCESSFUL	Se produjo un error.

Comentarios

Un complemento PSHED que participa en la recuperación de información de error establece los miembros Callbacks.RetrieveErrorInfo, Callbacks.FinalizeErrorRecord y Callbacks.ClearErrorStatus de la estructura WHEA_PSHED_PLUGIN_REGISTRATION_PACKET para que apunten a sus funciones de devolución de llamada RetrieveErrorInfo, FinalizeErrorRecord y ClearErrorStatus cuando el complemento llama a la función PshedRegisterPlugin para registrarse en el PSHED. El complemento PSHED también debe establecer la marca PshedFAErrorInfoRetrieval en el miembro FunctionalAreaMask de la estructura WHEA_PSHED_PLUGIN_REGISTRATION_PACKET.

En el caso de las condiciones de error de hardware corregidas, el kernel de Windows llama al PSHED para borrar el estado de error del origen del error se registra como el último paso del procesamiento del error. Si se registra un complemento PSHED para participar en la recuperación de información de error, PSHED llama a la función de devolución de llamada ClearErrorStatus del complemento PSHED para que el complemento PSHED pueda borrar los registros de estado de error adicionales específicos de la plataforma.