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 プラグインが PSHED に自身を登録するために PshedRegisterPlugin 関数を呼び出したときに、WHEA_PSHED_PLUGIN_REGISTRATION_PACKET 構造体の Context メンバーで指定されたコンテキスト領域へのポインター。

[in] Flags

クリア操作に影響を与えるフラグのビットごとの OR の組み合わせ。フラグは現在定義されていません。

[in] ErrorRecordId

システムの永続データ・ストレージからクリアされるエラー・レコードの ID。この識別子は、システムの永続データストレージに書き込まれた各WHEA_ERROR_RECORD構造体の Header.RecordId メンバーと比較して、クリアするエラーレコードを識別する必要があります。

戻り値

PSHED プラグインの ClearErrorRecord コールバック関数は、次のいずれかの NTSTATUS コードを返します。

リターンコード	説明
STATUS_SUCCESS	エラーレコードは、システムの永続データストレージから正常に消去されました。
STATUS_UNSUCCESSFUL	エラーが発生しました。

解説

エラーレコードの永続化に参加する PSHED プラグインは、プラグインが PshedRegisterPlugin 関数を呼び出して PSHED に登録するときに、WHEA_PSHED_PLUGIN_REGISTRATION_PACKET 構造体の Callbacks.WriteErrorRecord、Callbacks.ReadErrorRecord、および Callbacks.ClearErrorRecord メンバーを、その WriteErrorRecord、ReadErrorRecord、ClearErrorRecord コールバック関数を指すように設定します。 PSHED プラグインは、WHEA_PSHED_PLUGIN_REGISTRATION_PACKET構造体の FunctionalAreaMask メンバーに PshedFAErrorRecordPersistence フラグも設定する必要があります。

Windows カーネルは PSHED を呼び出して、システムの永続データストレージからエラーレコードをクリアします。エラーレコードの永続化に参加するために PSHED プラグインが登録されている場合、PSHED は PSHED プラグインの ClearErrorRecord コールバック関数を呼び出してクリア操作を実行します。システムの永続データストレージからエラーレコードをクリアするために使用されるメカニズムは、プラットフォーム固有です。