Edit

WheaHwErrorReportSubmitDeviceDriver function (ntddk.h)

  • Article

This routine submits an in progress error report to WHEA to be reported as a hardware error.

Syntax

NTSTATUS WheaHwErrorReportSubmitDeviceDriver(
  WHEA_ERROR_HANDLE ErrorHandle
);

Parameters

ErrorHandle

The handle returned by WheaCreateHwErrorReportDeviceDriver.

Return value

Returns STATUS_SUCCESS or one of the following:

  • STATUS_INVALID_HANDLE: Invalid error handle
  • STATUS_DEVICE_REMOVED: Error source has been removed
  • STATUS_BUFFER_TOO_SMALL: Packet contains no sections
  • STATUS_INSUFFICIENT_RESOURCES: Insufficient space for log data

Otherwise, this routine returns the status returned by WheaReportHwError.

Remarks

Before calling this routine, the driver should add all desired sections by calling WheaAddHwErrorReportSectionDeviceDriver.

After calling this routine, buffers in the buffer sets are no longer available for use, and the handle is invalid.

If an error has occurred, or the error is no longer valid, the driver can clean up without a report being submitted to WHEA by calling WheaHwErrorReportAbandonDeviceDriver.

For more info, see Using WHEA on Windows 10.

Requirements

Requirement Value
Minimum supported client Windows 10, version 2004
Header ntddk.h