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

包含驱动程序的硬件错误数据的缓冲区。 此信息特定于硬件,并且不得超过驱动程序提供给 WheaAddErrorSourceDeviceDriverMaxRawDataLength

ErrorDataLength

ULONG 类型的值,该值指定错误数据的大小(以字节为单位)。

SectionTypeGuid

指定要报告的错误数据的类型。 这可能是(但不一定)在 UEFI 规范的附录 N 中定义的 GUID 之一,在这种情况下,错误信息与指定的节类型之一相匹配。 调用方还可以创建 GUID 和专用节格式。

ErrorSeverity

类型的枚举值 WHEA_ERROR_SEVERITY 指定错误条件的严重性。

DeviceFriendlyName

长度最多为 20 字节的可选字符串 (包括 NULL 终止符) ,用于描述与错误条件关联的设备。 此信息将复制到生成的 WHEA 错误记录中,并且仅提供信息。 目的是将此信息放在错误记录中,以便在创建事件日志时,使用者可以轻松排查设备问题。

返回值

此函数方法返回STATUS_SUCCESS或相应的错误代码。

要求

要求
最低受支持的客户端 Windows 10 版本 1903
标头 ntddk.h

另请参阅

WheaAddErrorSourceDeviceDriver

WheaRemoveErrorSourceDeviceDriver