PSHED_PI_INJECT_ERROR función de devolución de llamada (ntddk.h)
La función de devolución de llamada InjectError de un complemento PSHED inserta un error en la plataforma de hardware.
Sintaxis
PSHED_PI_INJECT_ERROR PshedPiInjectError;
NTSTATUS PshedPiInjectError(
[in, out, optional] PVOID PluginContext,
[in] ULONGLONG ErrorType,
[in] ULONGLONG Parameter1,
[in] ULONGLONG Parameter2,
[in] ULONGLONG Parameter3,
[in] ULONGLONG Parameter4
)
{...}
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] ErrorType
Tipo de error que se va a insertar en la plataforma de hardware. Los valores posibles son:
INJECT_ERRTYPE_PROCESSOR_CORRECTABLE
Error de procesador que se puede corregir.
INJECT_ERRTYPE_PROCESSOR_UNCORRECTABLENONFATAL
Error de procesador no irrecuperable.
INJECT_ERRTYPE_PROCESSOR_UNCORRECTABLEFATAL
Error irrecuperable del procesador irrecuperable.
INJECT_ERRTYPE_MEMORY_CORRECTABLE
Un error de memoria corregible.
INJECT_ERRTYPE_MEMORY_UNCORRECTABLENONFATAL
Error de memoria no irrecuperable.
INJECT_ERRTYPE_MEMORY_UNCORRECTABLEFATAL
Error de memoria irrecuperable irrecuperable.
INJECT_ERRTYPE_PCIEXPRESS_CORRECTABLE
Error PCI Express que se puede corregir.
INJECT_ERRTYPE_PCIEXPRESS_UNCORRECTABLENONFATAL
Error no irrecuperable de PCI Express.
INJECT_ERRTYPE_PCIEXPRESS_UNCORRECTABLEFATAL
Error irrecuperable de PCI Express irrecuperable.
INJECT_ERRTYPE_PLATFORM_CORRECTABLE
Error de plataforma que se puede corregir.
INJECT_ERRTYPE_PLATFORM_UNCORRECTABLENONFATAL
Error de plataforma no irrecuperable.
INJECT_ERRTYPE_PLATFORM_UNCORRECTABLEFATAL
Error irrecuperable de la plataforma irrecuperable.
[in] Parameter1
Parámetro genérico que contiene datos adicionales que pasa la aplicación de administración de WHEA que inserta el error.
[in] Parameter2
Parámetro genérico que contiene datos adicionales que pasa la aplicación de administración de WHEA que inserta el error.
[in] Parameter3
Parámetro genérico que contiene datos adicionales que pasa la aplicación de administración de WHEA que inserta el error.
[in] Parameter4
Parámetro genérico que contiene datos adicionales que pasa la aplicación de administración de WHEA que inserta el error.
Valor devuelto
Una función de devolución de llamada InjectError del complemento PSHED devuelve uno de los siguientes códigos NTSTATUS:
| Código devuelto | Descripción |
|---|---|
| STATUS_SUCCESS | El error se insertó correctamente en la plataforma de hardware. |
| STATUS_UNSUCCESSFUL | Se produjo un error. Para los errores insertados que son irrecuperables o irrecuperables, es posible que esta función de devolución de llamada no se devuelva antes de que el sistema operativo genere una comprobación de errores en respuesta a la condición de error. |
Comentarios
Un complemento PSHED que participa en la inserción de errores establece los miembros Callbacks.GetInjectionCapabilities y Callbacks.InjectError de la estructura de WHEA_PSHED_PLUGIN_REGISTRATION_PACKET para apuntar a sus funciones de devolución de llamada GetInjectionCapabilities e InjectError cuando el complemento llama a la función PshedRegisterPlugin para registrarse con el PSHED. El complemento PSHED también debe establecer la marca PshedFAErrorInjection en el miembro FunctionalAreaMask de la estructura WHEA_PSHED_PLUGIN_REGISTRATION_PACKET.
Cuando una aplicación de administración de WHEA realiza una solicitud para insertar un error de hardware, el kernel de Windows llama al PSHED para insertar el error en la plataforma de hardware. Si se registra un complemento PSHED para participar en la inserción de errores, el PSHED llama a la función de devolución de llamada InsertError del complemento PSHED para realizar la operación de inyección de errores.
La aplicación de administración de WHEA que inserta el error puede pasar datos adicionales específicos del error a la función de devolución de llamada InsertError del complemento PSHED mediante parámetros Parameter1 a Parameter4. Por ejemplo, en sistemas basados en Itanium, algunas de las operaciones de inserción de errores requieren una dirección complementaria. En esta situación, la aplicación de administración de WHEA puede pasar la dirección a la función de devolución de llamada InjectError del complemento PSHED mediante uno de estos parámetros.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Compatible con Windows Server 2008, Windows Vista SP1 y versiones posteriores de Windows. |
| Plataforma de destino | Escritorio |
| Encabezado | ntddk.h (incluya Ntddk.h) |
| IRQL | IRQL = DISPATCH_LEVEL |