PSHED_PI_GET_INJECTION_CAPABILITIES回调函数 (ntddk.h)

PSHED 插件的 GetInjectionCapabilities 回调函数返回错误注入功能联合,描述可以注入到硬件平台的硬件错误类型。

语法

PSHED_PI_GET_INJECTION_CAPABILITIES PshedPiGetInjectionCapabilities;

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

参数

[in, out, optional] PluginContext

指向在 WHEA_PSHED_PLUGIN_REGISTRATION_PACKET上下文 结构成员中指定的上下文区域的指针,当 PSHED 插件调用 PshedRegisterPlugin 函数以向 PSHED 注册自身时。

[out] Capabilities

指向 WHEA_ERROR_INJECTION_CAPABILITIES 联合的指针。 此联合接收描述可注入到硬件平台的硬件错误类型的数据。

返回值

PSHED 插件的 GetInjectionCapabilities 回调函数返回以下 NTSTATUS 代码之一:

返回代码 描述
STATUS_SUCCESS 描述可注入硬件平台的硬件错误类型的数据在 功能 参数指向的 WHEA_ERROR_INJECTION_CAPABILITIES 联合中成功返回。
STATUS_UNSUCCESSFUL 发生错误。

言论

参与错误注入的 PSHED 插件将 Callbacks.GetInjectionCapabilitiesCallbacks.InjectErrorWHEA_PSHED_PLUGIN_REGISTRATION_PACKET 结构的成员指向其 当插件调用 PshedRegisterPlugin 函数以向 PSHED 注册自身时,GetInjectionCapabilitiesInjectError 回调函数。 PSHED 插件还必须在 WHEA_PSHED_PLUGIN_REGISTRATION_PACKET 结构的 FunctionalAreaMask 成员中设置 PshedFAErrorInjection 标志。

Windows 内核调用 PSHED,以检索有关可以注入到硬件平台的硬件错误类型的信息,以响应 WHEA 管理应用程序的错误注入功能查询。 如果注册 PSHED 插件以参与错误注入,PSHED 将调用 PSHED 插件的 GetInjectionCapabilities 回调函数,以检索有关可以注入到硬件平台的其他类型硬件错误的信息。

要求

要求 价值
目标平台 桌面
标头 ntddk.h (包括 Ntddk.h)
IRQL IRQL = DISPATCH_LEVEL

另请参阅

InjectError

PshedRegisterPlugin

WHEA_ERROR_INJECTION_CAPABILITIES

WHEA_PSHED_PLUGIN_REGISTRATION_PACKET