PSHED_PI_CLEAR_ERROR_RECORD回调函数 (ntddk.h)

项目
08/07/2023

PSHED 插件的 ClearErrorRecord 回调函数从系统的永久性数据存储中清除指定的错误记录。

语法

PSHED_PI_CLEAR_ERROR_RECORD PshedPiClearErrorRecord;

NTSTATUS PshedPiClearErrorRecord(
  [in, out, optional] PVOID PluginContext,
  [in]                ULONG Flags,
  [in]                ULONGLONG ErrorRecordId
)
{...}

参数

[in, out, optional] PluginContext

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

[in] Flags

影响清除操作的标志的按位 OR 组合。当前未定义任何标志。

[in] ErrorRecordId

正在从系统的永久性数据存储中清除的错误记录的标识符。应将此标识符与已写入系统持久性数据存储的每个WHEA_ERROR_RECORD结构的 Header.RecordId 成员进行比较，以标识要清除的错误记录。

返回值

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

返回代码	说明
STATUS_SUCCESS	错误记录已成功从系统的永久性数据存储中清除。
STATUS_UNSUCCESSFUL	出现了错误。

注解

参与错误记录持久性的 PSHED 插件设置 Callbacks.WriteErrorRecord，当插件调用 PshedRegisterPlugin 函数以向 PSHED 注册自身时，WHEA_PSHED_PLUGIN_REGISTRATION_PACKET 结构的 Callbacks.ReadErrorRecord 和 Callbacks.ClearErrorRecord 成员指向其 WriteErrorRecord、ReadErrorRecord 和 ClearErrorRecord 回调函数。 PSHED 插件还必须在 WHEA_PSHED_PLUGIN_REGISTRATION_PACKET 结构的 FunctionalAreaMask 成员中设置 PshedFAErrorRecordPersistence 标志。

Windows 内核调用 PSHED，以从系统的持久数据存储中清除错误记录。如果注册 PSHED 插件以参与错误记录持久性，则 PSHED 会调用 PSHED 插件的 ClearErrorRecord 回调函数来执行清除操作。用于从系统的永久性数据存储中清除错误记录的机制特定于平台。