PSHED_PI_FINALIZE_ERROR_RECORD回调函数（ntddk.h）

项目
02/07/2025

PSHED 插件的 FinalizeErrorRecord 回调函数将补充错误记录部分添加到更全面地描述错误条件的错误记录部分。

语法

PSHED_PI_FINALIZE_ERROR_RECORD PshedPiFinalizeErrorRecord;

NTSTATUS PshedPiFinalizeErrorRecord(
  [in, out, optional] PVOID PluginContext,
  [in]                PWHEA_ERROR_SOURCE_DESCRIPTOR ErrorSource,
  [in]                ULONG BufferLength,
  [in, out]           PWHEA_ERROR_RECORD ErrorRecord
)
{...}

参数

[in, out, optional] PluginContext

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

[in] ErrorSource

指向描述报告硬件错误的错误源的 WHEA_ERROR_SOURCE_DESCRIPTOR 结构的指针。

[in] BufferLength

ErrorRecord 参数指向的缓冲区的大小（以字节为单位）。

[in, out] ErrorRecord

指向 WHEA_ERROR_RECORD 结构的指针，该结构描述使用补充错误记录部分更新的错误记录。

返回值

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

返回代码	描述
STATUS_SUCCESS	错误记录已成功更新，并包含任何补充错误记录部分。
STATUS_BUFFER_TOO_SMALL	BufferLength 参数指定的 ErrorRecord 参数指向的缓冲区的大小太小，无法包含错误记录（如果使用补充错误记录部分进行更新）。
STATUS_NOT_SUPPORTED	PSHED 插件不支持指定的错误源。
STATUS_UNSUCCESSFUL	发生错误。

言论

参与错误信息检索的 PSHED 插件将 Callbacks.RetrieveErrorInfo、Callbacks.FinalizeErrorRecord以及 Callbacks.ClearErrorStatus 指向 WHEA_PSHED_PLUGIN_REGISTRATION_PACKET 结构的成员其 RetrieveErrorInfo、FinalizeErrorRecord，并在插件调用 PshedRegisterPlugin 函数时，ClearErrorStatus 回调函数来向 PSHED 注册自身。 PSHED 插件还必须在 WHEA_PSHED_PLUGIN_REGISTRATION_PACKET 结构的 FunctionalAreaMask 成员中设置 PshedFAErrorInfoRetrieval 标志。

Windows 内核调用 PSHED，以便它可以将补充错误记录部分添加到错误记录。如果注册 PSHED 插件以参与错误信息检索，PSHED 将调用 PSHED 插件的 FinalizeErrorRecord 回调函数，以便 PSHED 插件可以将任何其他错误记录部分添加到更全面地描述错误条件的错误记录记录部分。

PSHED 插件必须确保它不会在错误记录末尾添加补充错误记录部分。 Windows 内核为包含特定错误记录而分配的内存量从 MaxRawDataLength 和 MaxSectionsPerRecord 描述报告硬件错误的错误源的 WHEA_ERROR_SOURCE_DESCRIPTOR 结构成员计算。如果 PSHED 插件需要额外的缓冲区空间来包含它添加到错误记录的补充错误记录节，则必须参与错误源发现，并增加 MaxSectionsPerRecord 每个错误源的 WHEA_ERROR_SOURCE_DESCRIPTOR 结构成员的值，以适当考虑任何补充错误记录节。