PSHED_PI_GET_INJECTION_CAPABILITIES コールバック関数 (ntddk.h)
PSHED プラグインの GetInjectionCapabilities コールバック関数は、ハードウェア プラットフォームに挿入できるハードウェア エラーの種類を記述するエラー挿入機能共用体を返します。
構文
PSHED_PI_GET_INJECTION_CAPABILITIES PshedPiGetInjectionCapabilities;
NTSTATUS PshedPiGetInjectionCapabilities(
[in, out, optional] PVOID PluginContext,
[out] PWHEA_ERROR_INJECTION_CAPABILITIES Capabilities
)
{...}
パラメーター
[in, out, optional] PluginContext
PSHED プラグインが PSHED に登録するために PshedRegisterPlugin 関数を呼び出したときに、WHEA_PSHED_PLUGIN_REGISTRATION_PACKET 構造体の Context メンバーで指定されたコンテキスト領域へのポインター。
[out] Capabilities
WHEA_ERROR_INJECTION_CAPABILITIES 共用体へのポインター。 この共用体は、ハードウェア プラットフォームに挿入できるハードウェア エラーの種類を記述するデータを受け取ります。
戻り値
PSHED プラグインの GetInjectionCapabilities コールバック関数は、次のいずれかの NTSTATUS コードを返します。
| リターン コード | 形容 |
|---|---|
| STATUS_SUCCESS | ハードウェア プラットフォームに挿入できるハードウェア エラーの種類を記述するデータは、Capabilities パラメーターによって示される WHEA_ERROR_INJECTION_CAPABILITIES 共用体で正常に返されました。 |
| STATUS_UNSUCCESSFUL | エラーが発生しました。 |
備考
エラー挿入に参加する PSHED プラグインは、Callbacks.GetInjectionCapabilities と Callbacks.InjectErrorWHEA_PSHED_PLUGIN_REGISTRATION_PACKET 構造体のメンバーを指すように設定します。 プラグインが PSHED に登録するために PshedRegisterPlugin 関数を呼び出すときに、GetInjectionCapabilities および InjectError コールバック関数を します。 また、PSHED プラグインは、WHEA_PSHED_PLUGIN_REGISTRATION_PACKET 構造体の FunctionalAreaMask メンバーに PshedFAErrorInjection フラグを設定する必要があります。
Windows カーネルは PSHED を呼び出して、WHEA 管理アプリケーションによるエラー挿入機能の問い合わせに応じてハードウェア プラットフォームに挿入できるハードウェア エラーの種類に関する情報を取得します。 PSHED プラグインがエラー挿入に参加するように登録されている場合、PSHED は PSHED プラグインの GetInjectionCapabilities コールバック関数を呼び出して、ハードウェア プラットフォームに挿入できる追加の種類のハードウェア エラーに関する情報を取得します。
必要条件
| 要件 | 価値 |
|---|---|
| ターゲット プラットフォーム の | デスクトップ |
| ヘッダー | ntddk.h (Ntddk.h を含む) |
| IRQL | IRQL = DISPATCH_LEVEL |