次の方法で共有

PSHED_PI_CLEAR_ERROR_RECORD コールバック関数 (ntddk.h)

  • [アーティクル]

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

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

戻り値

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

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

備考

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

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

必要条件

要件 価値
ターゲット プラットフォーム の デスクトップ
ヘッダー ntddk.h (Ntddk.h を含む)
IRQL IRQL = DISPATCH_LEVEL

関連項目

PshedRegisterPlugin

ReadErrorRecord

WHEA_ERROR_RECORD

WHEA_PSHED_PLUGIN_REGISTRATION_PACKET

WriteErrorRecord の