PSHED_PI_INJECT_ERROR función de devolución de llamada (ntddk.h)
Un complemento PSHED InsertError función de devolución de llamada 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 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 recuperable.
INJECT_ERRTYPE_PROCESSOR_UNCORRECTABLEFATAL
Error irrecuperable del procesador irrecuperable.
INJECT_ERRTYPE_MEMORY_CORRECTABLE
Un error de memoria que se puede corregir.
INJECT_ERRTYPE_MEMORY_UNCORRECTABLENONFATAL
Error de memoria no recuperable.
INJECT_ERRTYPE_MEMORY_UNCORRECTABLEFATAL
Error de memoria irrecuperable irrecuperable.
INJECT_ERRTYPE_PCIEXPRESS_CORRECTABLE
Error de PCI Express que se puede corregir.
INJECT_ERRTYPE_PCIEXPRESS_UNCORRECTABLENONFATAL
Error de PCI Express no irrecuperable irrecuperable.
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 recuperable.
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
Un complemento PSHED InjectError función de devolución de llamada 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 | 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. |
Observaciones
Un complemento PSHED que participa en la inserción de errores establece los Callbacks.GetInjectionCapabilities y Callbacks.InjectError miembros de la estructura de WHEA_PSHED_PLUGIN_REGISTRATION_PACKET para que apunten a sus GetInjectionCapabilities y InjectError funciones de devolución de llamada 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 de 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 inyección de errores, PSHED llama a la función de devolución de llamada del complemento PSHED InjectError 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 al complemento PSHED La función de devolución de llamada de InjectError mediante parámetros Parameter1 a través de Parameter4. Por ejemplo, en los 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 al complemento PSHED InjectError función de devolución de llamada mediante uno de estos parámetros.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Compatible con Windows Server 2008, Windows Vista SP1 y versiones posteriores de Windows. |
| de la plataforma de destino de | Escritorio |
| encabezado de | ntddk.h (incluya Ntddk.h) |
| irQL | IRQL = DISPATCH_LEVEL |