WheaAddErrorSourceDeviceDriver 関数 (ntddk.h)

デバイス ドライバーは、WheaAddErrorSourceDeviceDriver 呼び出してエラー ソースを追加します。

構文

NTSTATUS WheaAddErrorSourceDeviceDriver(
  PVOID                                          Context,
  PWHEA_ERROR_SOURCE_CONFIGURATION_DEVICE_DRIVER Configuration,
  ULONG                                          NumberPreallocatedErrorReports
);

パラメーター

Context

呼び出し元によって割り当てられたコンテキストへの省略可能なポインター。 WHEA は、ドライバーが提供するコールバック ルーチンのパラメーターとしてコンテキストを提供します。 NULL を指定できます。

Configuration

ドライバー提供のコールバック ルーチンのセットを含む WHEA_ERROR_SOURCE_CONFIGURATION_DEVICE_DRIVER 型の構造体へのポインター。

NumberPreallocatedErrorReports

事前割り当てするレコードの数を指定する ULONG 型の値。 詳細については、「解説」を参照してください。

戻り値

この関数メソッドは、エラー ソースが追加された場合にSTATUS_SUCCESSを返します。 それ以外の場合は、次のいずれかを返すことができます。

• STATUS_INVALID_PARAMETER: 構成に初期化または初期化解除コールバック ポインターがありません。
• STATUS_INVALID_PARAMETER_2: 無効なバージョンの構成が送信されました。
• STATUS_INSUFFICIENT_RESOURCES: WHEA は、エラー ソースとそのレコードに領域を割り当てませんでした。

備考

エラー ソースを削除するには、ドライバーは WheaRemoveErrorSourceDeviceDriver を呼び出します。

WHEA は、高 IRQL で報告されるエラーのメモリを事前に割り当てることもできます (つまり、デバイス割り込みのコンテキストで)。 PASSIVE_LEVELで報告されたエラー ソースの場合、事前割り当ては必要ありませんが、デバイス ドライバーがエラー ソースのエラーを DISPATCH_LEVEL 以上で報告する場合は、エラー レコードを事前割り当てする必要があります。

詳細については、「Windows 10 での WHEA の使用」を参照してください。

必要条件

要件	価値
サポートされる最小クライアント	Windows 10 バージョン 2004
ヘッダー	ntddk.h

関連項目

WheaRemoveErrorSourceDeviceDriverの

WheaReportHwErrorDeviceDriverの

WheaCreateHwErrorReportDeviceDriverの