PSHED_PI_DISABLE_ERROR_SOURCE回调函数 (ntddk.h)

项目
04/21/2023

PSHED 插件的 DisableErrorSource 回调函数禁用错误源。

语法

PSHED_PI_DISABLE_ERROR_SOURCE PshedPiDisableErrorSource;

NTSTATUS PshedPiDisableErrorSource(
  [in, out, optional] PVOID PluginContext,
  [in]                PWHEA_ERROR_SOURCE_DESCRIPTOR ErrorSource
)
{...}

参数

[in, out, optional] PluginContext

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

[in] ErrorSource

指向描述正在禁用的错误源 的WHEA_ERROR_SOURCE_DESCRIPTOR 结构的指针。

返回值

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

返回代码	说明
STATUS_SUCCESS	已成功禁用错误源。
STATUS_NOT_SUPPORTED	PSHED 插件不支持禁用指定的错误源。
STATUS_UNSUCCESSFUL	出现了错误。

注解

参与错误源代码管理的 PSHED 插件将 WHEA_PSHED_PLUGIN_REGISTRATION_PACKET 结构的 Callbacks.SetErrorSourceInfo、Callbacks.EnableErrorSource 和 Callbacks.DisableErrorSource 成员设置为在插件调用 PshedRegisterPlugin 函数时指向其 SetErrorSourceInfo、EnableErrorSource 和 DisableErrorSource 回调函数。 PSHED 插件还必须在 WHEA_PSHED_PLUGIN_REGISTRATION_PACKET 结构的 FunctionalAreaMask 成员中设置 PshedFAErrorSourceControl 标志。

Windows 内核调用 PSHED 以禁用错误源，以响应 WHEA 管理应用程序发出的错误源禁用请求。如果注册 PSHED 插件以参与错误源代码管理，则 PSHED 会调用 PSHED 插件的 DisableErrorSource 回调函数，为 PSHED 插件提供禁用错误源的机会。如果 DisableErrorSource 回调函数返回STATUS_NOT_SUPPORTED，则 PSHED 将禁用错误源。否则，PSHED 将仅返回 DisableErrorSource 回调函数返回的返回值。

如果 PSHED 插件成功禁用错误源，在调用 PSHED 插件的 DisableErrorSource 回调函数返回后，PSHED 将代表 PSHED 插件更新WHEA_ERROR_SOURCE_DESCRIPTOR结构。 PSHED 插件的 DisableErrorSource 回调函数不应修改错误源描述符。