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

Artículo
02/29/2024

La función de devolución de llamada DisableErrorSource de un complemento PSHED deshabilita un origen de error.

Sintaxis

PSHED_PI_DISABLE_ERROR_SOURCE PshedPiDisableErrorSource;

NTSTATUS PshedPiDisableErrorSource(
  [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á deshabilitando.

Valor devuelto

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

Código devuelto	Descripción
STATUS_SUCCESS	El origen del error se deshabilitó correctamente.
STATUS_NOT_SUPPORTED	El complemento PSHED no admite deshabilitar el 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 deshabilitar un origen de errores en respuesta a una solicitud de deshabilitación del origen de errores 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 DisableErrorSource del complemento PSHED para dar al complemento PSHED una oportunidad para deshabilitar el origen de errores. Si la función de devolución de llamada DisableErrorSource devuelve STATUS_NOT_SUPPORTED, el PSHED deshabilitará el origen del error. De lo contrario, el PSHED simplemente devolverá el valor devuelto por la función de devolución de llamada DisableErrorSource .

Si el complemento PSHED deshabilita 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 a la función de devolución de llamada DisableErrorSource del complemento PSHED. La función de devolución de llamada DisableErrorSource de un complemento PSHED no debe modificar el descriptor de origen del error.