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

Artículo
02/07/2025

Un complemento PSHED EnableErrorSource función de devolución de llamada 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 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á habilitando.

Valor devuelto

Un complemento PSHED EnableErrorSource 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 ha habilitado correctamente.
STATUS_NOT_SUPPORTED	El complemento PSHED no admite la habilitació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 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 de origen de errores. El kernel de Windows también llama al PSHED para habilitar un origen de error en respuesta a un origen de error que habilite la solicitud 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 al complemento PSHED EnableErrorSource función de devolución de llamada para dar al complemento PSHED una oportunidad para habilitar el origen de errores. Si el EnableErrorSource función de devolución de llamada devuelve STATUS_NOT_SUPPORTED, PSHED habilitará el origen del error. De lo contrario, el PSHED solo devolverá el valor devuelto por el EnableErrorSource función de devolución de llamada.

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