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

La función de devolución de llamada GetErrorSourceInfo de un complemento PSHED devuelve una estructura 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 con 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 origen de errores establece el miembro Callbacks.GetAllErrorSources y, opcionalmente, el miembro Callbacks.GetErrorSourceInfo de la estructura 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) que es 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 recopilada sobre el origen del error, 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 a medida que se implementa en la plataforma de hardware.

Requisitos

   
Cliente mínimo compatible Compatible con Windows Server 2008, Windows Vista SP1 y versiones posteriores de Windows.
Plataforma de destino Escritorio
Header ntddk.h (incluya Ntddk.h)
IRQL IRQL = DISPATCH_LEVEL

Vea también

GetAllErrorSources

PshedRegisterPlugin

WHEA_ERROR_SOURCE_DESCRIPTOR

WHEA_PSHED_PLUGIN_REGISTRATION_PACKET