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

Artículo
02/29/2024

Una función de devolución de llamada GetInjectionCapabilities del complemento PSHED devuelve una unión de funcionalidades de inserción de errores que describe los tipos de errores de hardware que se pueden insertar en la plataforma de hardware.

Sintaxis

PSHED_PI_GET_INJECTION_CAPABILITIES PshedPiGetInjectionCapabilities;

NTSTATUS PshedPiGetInjectionCapabilities(
  [in, out, optional] PVOID PluginContext,
  [out]               PWHEA_ERROR_INJECTION_CAPABILITIES Capabilities
)
{...}

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.

[out] Capabilities

Puntero a una unión WHEA_ERROR_INJECTION_CAPABILITIES . Esta unión recibe los datos que describen los tipos de errores de hardware que se pueden insertar en la plataforma de hardware.

Valor devuelto

Una función de devolución de llamada GetInjectionCapabilities del complemento PSHED devuelve uno de los siguientes códigos NTSTATUS:

Código devuelto	Descripción
STATUS_SUCCESS	Los datos que describen los tipos de errores de hardware que se pueden insertar en la plataforma de hardware se devolvieron correctamente en la unión de WHEA_ERROR_INJECTION_CAPABILITIES apuntado por el parámetro Capabilities .
STATUS_UNSUCCESSFUL	Se produjo un 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 .

El kernel de Windows llama al PSHED para recuperar información sobre los tipos de errores de hardware que se pueden insertar en la plataforma de hardware en respuesta a una consulta de funcionalidades de inyección de errores mediante una aplicación de administración de WHEA. 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 GetInjectionCapabilities del complemento PSHED para recuperar información sobre tipos adicionales de errores de hardware que se pueden insertar en la plataforma de hardware.