WheaReportHwErrorDeviceDriver 関数 (ntddk.h)

ハードウェア エラーを報告するために、ドライバーは WheaReportHwErrorDeviceDriver 関数を 呼び出します。

構文

NTSTATUS WheaReportHwErrorDeviceDriver(
  ULONG               ErrorSourceId,
  PDEVICE_OBJECT      DeviceObject,
  PUCHAR              ErrorData,
  ULONG               ErrorDataLength,
  LPGUID              SectionTypeGuid,
  WHEA_ERROR_SEVERITY ErrorSeverity,
  LPSTR               DeviceFriendlyName
);

パラメーター

ErrorSourceId

_WHEA_ERROR_SOURCE_INITIALIZE_DEVICE_DRIVER コールバックを呼び出したときに提供されるエラー ソース ID WHEA。

DeviceObject

エラー条件に関連付けられているデバイス オブジェクトへのポインター。

ErrorData

ドライバーのハードウェア エラー データを含むバッファー。 この情報はハードウェア固有であり、ドライバーが WheaAddErrorSourceDeviceDriver に提供した MaxRawDataLength を超えてはなりません。

ErrorDataLength

エラー データのサイズ (バイト単位) を指定する ULONG 型の値。

SectionTypeGuid

報告されるエラー データの種類を指定します。 これは、 UEFI 仕様の付録 N で定義されている GUID の 1 つである可能性がありますが、必須ではありません。この場合、エラー情報は指定されたセクションの種類のいずれかに一致します。 呼び出し元は、GUID とプライベート セクション形式を作成することもできます。

ErrorSeverity

エラー条件の重大度を指定 WHEA_ERROR_SEVERITY 型の列挙値。

DeviceFriendlyName

エラー条件に関連付けられているデバイスを記述する最大 20 バイトの長さ (NULL ターミネータを含む) の省略可能な文字列。 この情報は、結果として得られる WHEA エラー・レコードにコピーされ、情報のみになります。 目的は、イベント ログが作成されたときにコンシューマーがデバイスの問題を簡単にトラブルシューティングできるように、この情報をエラー レコードに配置することです。

戻り値

この関数メソッドは、STATUS_SUCCESSまたは適切なエラー コードを返します。

要件

こちらもご覧ください

WheaAddErrorSourceDeviceDriver

WheaRemoveErrorSourceDeviceDriver