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

Artículo
02/29/2024

Una función de devolución de llamada GetErrorSourceInfo del complemento PSHED 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 de 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

Una función de devolución de llamada GetErrorSourceInfo del complemento PSHED 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	Se produjo un error.

Comentarios

Un complemento PSHED que participa en la detección de orígenes de errores establece el miembro Callbacks.GetAllErrorSources y, opcionalmente, el miembro Callbacks.GetErrorSourceInfo de la estructura de WHEA_PSHED_PLUGIN_REGISTRATION_PACKET para apuntar a sus funciones de devolución de llamada GetAllErrorSources y GetErrorSourceInfo cuando el complemento llama a la función PshedRegisterPlugin para registrarse con el PSHED. El complemento PSHED también debe establecer la marca 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 de errores, PSHED llama a la función de devolución de llamada GetErrorSourceInfo del complemento PSHED para que el complemento PSHED pueda proporcionar detalles adicionales sobre el origen del error. La función de devolución de llamada GetErrorSourceInfo 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.