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

Artículo
02/07/2025

Un complemento PSHED GetErrorSourceInfo función de devolución de llamada devuelve una estructura de descriptor de origen de error que representa un origen de error determinado implementado por la plataforma de hardware.

Sintaxis

PSHED_PI_GET_ERROR_SOURCE_INFO PshedPiGetErrorSourceInfo;

NTSTATUS PshedPiGetErrorSourceInfo(
  [in, out, optional] PVOID PluginContext,
  [in, out]           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, out] ErrorSource

Puntero a una estructura de WHEA_ERROR_SOURCE_DESCRIPTOR que representa un origen de error determinado implementado por la plataforma de hardware.

Valor devuelto

Un complemento PSHED GetErrorSourceInfo función de devolución de llamada devuelve uno de los siguientes códigos NTSTATUS:

Código devuelto	Descripción
STATUS_SUCCESS	La información de origen del error se actualizó correctamente.
STATUS_UNSUCCESSFUL	Error.

Observaciones

Un complemento PSHED que participa en la detección de origen de errores establece el miembro Callbacks.GetAllErrorSources y, opcionalmente, el miembro Callbacks.GetErrorSourceInfo de la estructura de WHEA_PSHED_PLUGIN_REGISTRATION_PACKET para que apunte a su GetAllErrorSources y GetErrorSourceInfo funciones de devolución de llamada cuando el complemento llama a la función PshedRegisterPlug in para registrarse en el PSHED. El complemento PSHED también debe establecer la marca de PshedFADiscovery en el miembro FunctionalAreaMask de la estructura WHEA_PSHED_PLUGIN_REGISTRATION_PACKET.

El kernel de Windows llama al PSHED para obtener detalles adicionales sobre un origen de error determinado. Esto ocurre cuando un controlador de bus agrega un nuevo origen de error al sistema. Por ejemplo, cuando el controlador PCI detecta un dispositivo PCI Express (PCIe) capaz de notificar errores PCIe, notifica el origen de errores al sistema operativo.

Si se registra un complemento PSHED para participar en la detección de origen de errores y ha implementado una función de devolución de llamada GetErrorSourceInfo, después de que PSHED haya actualizado la estructura del descriptor de origen de errores con la información que ha recopilado sobre el origen del error, PSHED llama a la función de devolución de llamada del complemento PSHED GetErrorSourceInfo para que el complemento PSHED pueda proporcionar detalles adicionales sobre el origen del error. El GetErrorSourceInfo función de devolución de llamada actualiza el contenido de la estructura del descriptor de origen de errores para que represente con precisión el origen del error tal como lo implementa la plataforma de hardware.