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

[アーティクル]
04/21/2023

PSHED プラグインの EnableErrorSource コールバック関数を使用すると、エラーソースが有効になります。

構文

PSHED_PI_ENABLE_ERROR_SOURCE PshedPiEnableErrorSource;

NTSTATUS PshedPiEnableErrorSource(
  [in, out, optional] PVOID PluginContext,
  [in]                PWHEA_ERROR_SOURCE_DESCRIPTOR ErrorSource
)
{...}

パラメーター

[in, out, optional] PluginContext

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

[in] ErrorSource

有効になっているエラーソースを記述する WHEA_ERROR_SOURCE_DESCRIPTOR 構造体へのポインター。

戻り値

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

リターンコード	説明
STATUS_SUCCESS	エラーソースが正常に有効になりました。
STATUS_NOT_SUPPORTED	PSHED プラグインは、指定されたエラーソースの有効化をサポートしていません。
STATUS_UNSUCCESSFUL	エラーが発生しました。

解説

エラーソース管理に参加する PSHED プラグインは、PshedRegisterPlugin 関数を呼び出して PSHED に登録するときに、WHEA_PSHED_PLUGIN_REGISTRATION_PACKET 構造体の Callbacks.SetErrorSourceInfo、Callbacks.EnableErrorSource、Callbacks.DisableErrorSource の各メンバーを SetErrorSourceInfo、EnableErrorSource、DisableErrorSource コールバック関数を指すように設定します。 PSHED プラグインは、WHEA_PSHED_PLUGIN_REGISTRATION_PACKET構造体の FunctionalAreaMask メンバーに PshedFAErrorSourceControl フラグを設定する必要もあります。

Windows カーネルは PSHED を呼び出して、エラーソースの検出中に報告された各エラーソースを有効にします。また、WINDOWS カーネルは PSHED を呼び出して、WHEA 管理アプリケーションによるエラーソース有効化要求に応答してエラーソースを有効にします。 PSHED プラグインがエラーソース管理に参加するように登録されている場合、PSHED は PSHED プラグインの EnableErrorSource コールバック関数を呼び出して、PSHED プラグインにエラーソースを有効にする機会を提供します。 EnableErrorSource コールバック関数がSTATUS_NOT_SUPPORTEDを返す場合、PSHED によってエラーソースが有効になります。それ以外の場合、PSHED は EnableErrorSource コールバック関数によって返される戻り値のみを返します。

PSHED プラグインがエラーソースを正常に有効にした場合、PSHED プラグインの EnableErrorSource コールバック関数の呼び出しが返された後、PSHED プラグインに代わって WHEA_ERROR_SOURCE_DESCRIPTOR 構造が更新されます。 PSHED プラグインの EnableErrorSource コールバック関数は、エラーソース記述子を変更しないでください。