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 の使用」を参照してください。

要件

こちらもご覧ください

WheaRemoveErrorSourceDeviceDriver

WheaReportHwErrorDeviceDriver

WheaCreateHwErrorReportDeviceDriver