PSHED_PI_ENABLE_ERROR_SOURCE コールバック関数 (ntddk.h)
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 プラグインは、Callbacks.SetErrorSourceInfo、Callbacks.EnableErrorSource、および Callbacks.DisableErrorSource メンバーをその WHEA_PSHED_PLUGIN_REGISTRATION_PACKET 構造体のメンバーに設定します。 SetErrorSourceInfo、EnableErrorSource の、および DisableErrorSource コールバック関数は、プラグインが PSHED に登録するために PshedRegisterPlugin 関数を呼び出すときです。 また、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 コールバック関数は、エラー ソース記述子を変更しないでください。
必要条件
| 要件 | 価値 |
|---|---|
| ターゲット プラットフォーム の | デスクトップ |
| ヘッダー | ntddk.h (Ntddk.h を含む) |
| IRQL | IRQL = DISPATCH_LEVEL |
関連項目
DisableErrorSource の
SetErrorSourceInfo の