PSHED_PI_SET_ERROR_SOURCE_INFO回调函数（ntddk.h）

项目
02/07/2025

PSHED 插件的 SetErrorSourceInfo 回调函数配置错误源。

语法

PSHED_PI_SET_ERROR_SOURCE_INFO PshedPiSetErrorSourceInfo;

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

参数

[in, out, optional] PluginContext

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

[in] ErrorSource

指向描述所配置错误源的 WHEA_ERROR_SOURCE_DESCRIPTOR 结构的指针。

返回值

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

返回代码	描述
STATUS_SUCCESS	错误源已成功配置。
STATUS_NOT_SUPPORTED	PSHED 插件不支持指定错误源的配置。
STATUS_UNSUCCESSFUL	发生错误。

言论

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

Windows 内核调用 PSHED 以配置错误源，以响应 WHEA 管理应用程序的错误源配置请求。如果注册 PSHED 插件以参与错误源代码管理，PSHED 将调用 PSHED 插件的 SetErrorSourceInfo 回调函数，使 PSHED 插件有机会执行错误源配置作。错误源配置数据包含在 ErrorSource 参数指向的 WHEA_ERROR_SOURCE_DESCRIPTOR 结构中。

如果 PSHED 插件不支持指定错误源的配置，则 SetErrorSourceInfo 回调函数返回STATUS_NOT_SUPPORTED。在这种情况下，PSHED 执行请求的错误源配置作。

如果 PSHED 插件支持配置指定的错误源，则 SetErrorSourceInfo 回调函数应将错误源的配置数据保存在注册表、系统的 BIOS 表中，或某种形式的非易失性数据存储（可用于错误源）。错误源用于存储错误源配置数据的特定形式是特定于实现的。 SetErrorSourceInfo 回调函数应将配置数据应用于错误源，这样配置更改将在下次重新启动系统时生效。重新启动系统后，PSHED 插件应在错误源发现期间向作系统报告错误源的新错误源配置数据。