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

Artículo
02/29/2024

La función de devolución de llamada EnableErrorSource de un complemento PSHED habilita un origen de error.

Sintaxis

PSHED_PI_ENABLE_ERROR_SOURCE PshedPiEnableErrorSource;

NTSTATUS PshedPiEnableErrorSource(
  [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 de WHEA_ERROR_SOURCE_DESCRIPTOR que describe el origen de error que se está habilitando.

Valor devuelto

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

Código devuelto	Descripción
STATUS_SUCCESS	El origen del error se ha habilitado correctamente.
STATUS_NOT_SUPPORTED	El complemento PSHED no admite la habilitació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 habilitar cada uno de los orígenes de error que se notificaron durante la detección del origen de errores. El kernel de Windows también llama al PSHED para habilitar un origen de errores en respuesta a una solicitud de habilitación del origen de errores mediante 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 EnableErrorSource del complemento PSHED para dar al complemento PSHED una oportunidad para habilitar el origen de errores. Si la función de devolución de llamada EnableErrorSource devuelve STATUS_NOT_SUPPORTED, PSHED habilitará el origen del error. De lo contrario, el PSHED simplemente devolverá el valor devuelto que devuelve la función de devolución de llamada EnableErrorSource .

Si el complemento PSHED habilita correctamente el origen del error, el PSHED actualizará la estructura WHEA_ERROR_SOURCE_DESCRIPTOR en nombre del complemento PSHED después de la llamada a la función de devolución de llamada EnableErrorSource del complemento PSHED. La función de devolución de llamada EnableErrorSource de un complemento PSHED no debe modificar el descriptor de origen del error.