PSHED_PI_SET_ERROR_SOURCE_INFO回调函数 (ntddk.h)

项目
02/26/2024

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

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

[in] ErrorSource

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

返回值

PSHED 插件的 SetErrorSourceInfo 回调函数返回以下 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 插件的 SetErrorSourceInfo 回调函数，为 PSHED 插件提供执行错误源配置操作的机会。错误源配置数据包含在 ErrorSource 参数指向的 WHEA_ERROR_SOURCE_DESCRIPTOR 结构中。

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

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