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.GetInjectionCapabilities 和 Callbacks.InjectErrorWHEA_PSHED_PLUGIN_REGISTRATION_PACKET 结构的成员指向其 当插件调用 PshedRegisterPlugin 函数以向 PSHED 注册自身时,GetInjectionCapabilities 和 InjectError 回调函数。 PSHED 插件还必须在 WHEA_PSHED_PLUGIN_REGISTRATION_PACKET 结构的 FunctionalAreaMask 成员中设置 PshedFAErrorInjection 标志。
Windows 内核调用 PSHED,以检索有关可以注入到硬件平台的硬件错误类型的信息,以响应 WHEA 管理应用程序的错误注入功能查询。 如果注册 PSHED 插件以参与错误注入,PSHED 将调用 PSHED 插件的 GetInjectionCapabilities 回调函数,以检索有关可以注入到硬件平台的其他类型硬件错误的信息。
要求
要求 | 价值 |
---|---|
目标平台 | 桌面 |
标头 | ntddk.h (包括 Ntddk.h) |
IRQL | IRQL = DISPATCH_LEVEL |