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

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

PSHED プラグインの DisableErrorSource コールバック関数は、エラーソースを無効にします。

構文

PSHED_PI_DISABLE_ERROR_SOURCE PshedPiDisableErrorSource;

NTSTATUS PshedPiDisableErrorSource(
  [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 プラグインの DisableErrorSource コールバック関数は、次のいずれかの 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 を呼び出して、WHEA 管理アプリケーションによるエラーソース無効化要求に応答してエラーソースを無効にします。 PSHED プラグインがエラーソース管理に参加するように登録されている場合、PSHED は PSHED プラグインの DisableErrorSource コールバック関数を呼び出して、PSHED プラグインにエラーソースを無効にする機会を与えます。 DisableErrorSource コールバック関数がSTATUS_NOT_SUPPORTEDを返すと、PSHED によってエラーソースが無効になります。それ以外の場合、PSHED は DisableErrorSource コールバック関数によって返される戻り値のみを返します。

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