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

Artículo
02/29/2024

La función de devolución de llamada SetErrorSourceInfo de un complemento PSHED configura un origen de error.

Sintaxis

PSHED_PI_SET_ERROR_SOURCE_INFO PshedPiSetErrorSourceInfo;

NTSTATUS PshedPiSetErrorSourceInfo(
  [in, out, optional] PVOID PluginContext,
  [in]                PWHEA_ERROR_SOURCE_DESCRIPTOR ErrorSource
)
{...}

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 WHEA_ERROR_SOURCE_DESCRIPTOR que describe el origen de error que se está configurando.

Valor devuelto

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

Código devuelto	Descripción
STATUS_SUCCESS	El origen del error se configuró correctamente.
STATUS_NOT_SUPPORTED	El complemento PSHED no admite la configuración del origen de error especificado.
STATUS_UNSUCCESSFUL	Se produjo un error.

Comentarios

Un complemento PSHED que participa en el control de código fuente de error establece los miembros Callbacks.SetErrorSourceInfo, Callbacks.EnableErrorSource y Callbacks.DisableErrorSource de la estructura WHEA_PSHED_PLUGIN_REGISTRATION_PACKET para que apunten a sus funciones de devolución de llamada SetErrorSource, EnableErrorSource y DisableErrorSource cuando el complemento llama a la función PshedRegisterPlugin para registrarse con el PSHED. El complemento PSHED también debe establecer la marca PshedFAErrorSourceControl en el miembro FunctionalAreaMask de la estructura WHEA_PSHED_PLUGIN_REGISTRATION_PACKET.

El kernel de Windows llama al PSHED para configurar un origen de error en respuesta a una solicitud de configuración de origen de error por parte de una aplicación de administración de WHEA. Si se registra un complemento PSHED para participar en el control de código fuente de error, PSHED llama a la función de devolución de llamada SetErrorSourceInfo del complemento PSHED para dar al complemento PSHED una oportunidad para realizar la operación de configuración del origen de errores. Los datos de configuración del origen de errores se incluyen en la estructura WHEA_ERROR_SOURCE_DESCRIPTOR a la que apunta el parámetro ErrorSource .

Si el complemento PSHED no admite la configuración del origen de error especificado, la función de devolución de llamada SetErrorSourceInfo devuelve STATUS_NOT_SUPPORTED. En esta situación, el PSHED realiza la operación de configuración de origen de error solicitada.

Si el complemento PSHED admite la configuración del origen de error especificado, la función de devolución de llamada SetErrorSourceInfo debe guardar los datos de configuración del origen del error en el Registro, en las tablas bios del sistema o en algún otro tipo de almacenamiento de datos no volátil que esté disponible para el origen de error. La forma específica de almacenamiento de datos no volátil que usa un origen de error para almacenar los datos de configuración del origen de error es específico de la implementación. La función de devolución de llamada SetErrorSourceInfo debe aplicar los datos de configuración al origen de errores de forma que los cambios de configuración surtan efecto la próxima vez que se reinicie el sistema. Cuando se reinicia el sistema, el complemento PSHED debe notificar los nuevos datos de configuración del origen de errores para el origen de errores al sistema operativo durante la detección del origen de errores.