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

[アーティクル]
02/29/2024

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 プラグインは、PshedRegisterPlugin 関数を呼び出して PSHED に登録するときに、WHEA_PSHED_PLUGIN_REGISTRATION_PACKET構造体の Callbacks.GetInjectionCapabilities および Callbacks.InjectError メンバーを、その GetInjectionCapabilities および InjectError コールバック関数を指すように設定します。 PSHED プラグインは、WHEA_PSHED_PLUGIN_REGISTRATION_PACKET構造体の FunctionalAreaMask メンバーに PshedFAErrorInjection フラグを設定する必要もあります。

Windows カーネルは PSHED を呼び出して、WHEA 管理アプリケーションによるエラー挿入機能の問い合わせに応じて、ハードウェアプラットフォームに挿入できるハードウェアエラーの種類に関する情報を取得します。 PSHED プラグインがエラー挿入に参加するように登録されている場合、PSHED は PSHED プラグインの GetInjectionCapabilities コールバック関数を呼び出して、ハードウェアプラットフォームに挿入できる追加の種類のハードウェアエラーに関する情報を取得します。