PSHED_PI_INJECT_ERROR コールバック関数 (ntddk.h)
PSHED プラグインの InjectError コールバック関数は、ハードウェア プラットフォームにエラーを挿入します。
構文
PSHED_PI_INJECT_ERROR PshedPiInjectError;
NTSTATUS PshedPiInjectError(
[in, out, optional] PVOID PluginContext,
[in] ULONGLONG ErrorType,
[in] ULONGLONG Parameter1,
[in] ULONGLONG Parameter2,
[in] ULONGLONG Parameter3,
[in] ULONGLONG Parameter4
)
{...}
パラメーター
[in, out, optional] PluginContext
PSHED プラグインが PSHED に自身を登録するために PshedRegisterPlugin 関数を呼び出したときに、WHEA_PSHED_PLUGIN_REGISTRATION_PACKET 構造体の Context メンバーで指定されたコンテキスト領域へのポインター。
[in] ErrorType
ハードウェア プラットフォームに挿入されるエラーの種類。 次のいずれかの値になります。
INJECT_ERRTYPE_PROCESSOR_CORRECTABLE
修正可能なプロセッサ エラー。
INJECT_ERRTYPE_PROCESSOR_UNCORRECTABLENONFATAL
修正不可能な致命的でないプロセッサ エラー。
INJECT_ERRTYPE_PROCESSOR_UNCORRECTABLEFATAL
修正できない致命的なプロセッサ エラー。
INJECT_ERRTYPE_MEMORY_CORRECTABLE
修正可能なメモリ エラー。
INJECT_ERRTYPE_MEMORY_UNCORRECTABLENONFATAL
修正不可能な致命的でないメモリ エラー。
INJECT_ERRTYPE_MEMORY_UNCORRECTABLEFATAL
修正できない致命的なメモリ エラー。
INJECT_ERRTYPE_PCIEXPRESS_CORRECTABLE
修正可能な PCI Express エラー。
INJECT_ERRTYPE_PCIEXPRESS_UNCORRECTABLENONFATAL
修正不可能な致命的でない PCI Express エラー。
INJECT_ERRTYPE_PCIEXPRESS_UNCORRECTABLEFATAL
修正できない致命的な PCI Express エラー。
INJECT_ERRTYPE_PLATFORM_CORRECTABLE
修正可能なプラットフォーム エラー。
INJECT_ERRTYPE_PLATFORM_UNCORRECTABLENONFATAL
修正不可能な致命的でないプラットフォーム エラー。
INJECT_ERRTYPE_PLATFORM_UNCORRECTABLEFATAL
修正不可能な致命的なプラットフォーム エラー。
[in] Parameter1
エラーを挿入している WHEA 管理アプリケーションによって渡される追加データを含むジェネリック パラメーター。
[in] Parameter2
エラーを挿入している WHEA 管理アプリケーションによって渡される追加データを含むジェネリック パラメーター。
[in] Parameter3
エラーを挿入している WHEA 管理アプリケーションによって渡される追加データを含むジェネリック パラメーター。
[in] Parameter4
エラーを挿入している WHEA 管理アプリケーションによって渡される追加データを含むジェネリック パラメーター。
戻り値
PSHED プラグインの InjectError コールバック関数は、次のいずれかの NTSTATUS コードを返します。
| リターン コード | 説明 |
|---|---|
| STATUS_SUCCESS | エラーがハードウェア プラットフォームに正常に挿入されました。 |
| STATUS_UNSUCCESSFUL | エラーが発生しました。 致命的なエラーや回復不能な挿入されたエラーの場合、このコールバック関数は、オペレーティング システムがエラー状態に応答してバグ チェックを生成する前に戻らない可能性があります。 |
注釈
エラー挿入に参加する PSHED プラグインは、プラグインが PshedRegisterPlugin 関数を呼び出して PSHED に登録するときに、その GetInjectionCapabilities および InjectError コールバック関数を指すように、WHEA_PSHED_PLUGIN_REGISTRATION_PACKET 構造体の Callbacks.GetInjectionCapabilities および Callbacks.InjectError メンバーを設定します。 また、PSHED プラグインは、WHEA_PSHED_PLUGIN_REGISTRATION_PACKET構造体の FunctionalAreaMask メンバーに PshedFAErrorInjection フラグを設定する必要があります。
WHEA 管理アプリケーションがハードウェア エラーを挿入する要求を行うと、Windows カーネルは PSHED を呼び出してハードウェア プラットフォームにエラーを挿入します。 エラー挿入に参加するために PSHED プラグインが登録されている場合、PSHED は PSHED プラグインの InjectError コールバック関数を呼び出してエラー挿入操作を実行します。
エラーを挿入している WHEA 管理アプリケーションは、パラメーター Parameter1 から Parameter4 を使用して、追加のエラー固有のデータを PSHED プラグインの InjectError コールバック関数に渡すことができます。 たとえば、Itanium ベースのシステムでは、一部のエラー挿入操作には付随するアドレスが必要です。 この状況では、WHEA 管理アプリケーションは、これらのパラメーターのいずれかを使用して、PSHED プラグインの InjectError コールバック関数にアドレスを渡すことができます。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Server 2008、Windows Vista SP1、およびそれ以降のバージョンの Windows でサポートされています。 |
| 対象プラットフォーム | デスクトップ |
| Header | ntddk.h (Ntddk.h を含む) |
| IRQL | IRQL = DISPATCH_LEVEL |