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

Artículo
02/07/2025

Un complemento PSHED SetErrorSourceInfo función de devolución de llamada 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 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] ErrorSource

Puntero a una estructura de WHEA_ERROR_SOURCE_DESCRIPTOR que describe el origen de error que se está configurando.

Valor devuelto

Un complemento PSHED SetErrorSourceInfo función de devolución de llamada 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	Error.

Observaciones

Un complemento PSHED que participa en el control de código fuente de errores establece los Callbacks.SetErrorSourceInfo, Callbacks.EnableErrorSourcey Callbacks.DisableErrorSource miembros de la estructura de WHEA_PSHED_PLUGIN_REGISTRATION_PACKET que apuntar en su SetErrorSourceInfo, EnableErrorSourcey DisableErrorSource 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 PshedFAErrorSourceControl del 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 al complemento PSHED SetErrorSourceInfo función de devolución de llamada 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 de 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 SetErrorSourceInfo función de devolución de llamada devuelve STATUS_NOT_SUPPORTED. En esta situación, el PSHED realiza la operación de configuración del origen de errores solicitada.

Si el complemento PSHED admite la configuración del origen de error especificado, el SetErrorSourceInfo función de devolución de llamada debe guardar los datos de configuración del origen de error en el Registro, en las tablas del 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 errores es específica de la implementación. El SetErrorSourceInfo función de devolución de llamada debe aplicar los datos de configuración al origen de errores de tal forma que los cambios de configuración se vuelvan efectivos 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 del error al sistema operativo durante la detección de origen de errores.