Edit

WheaAddHwErrorReportSectionDeviceDriver function (ntddk.h)

  • Article

This routine adds a new section to an error report, and hands the caller a buffer set that can be populated with information.

Syntax

NTSTATUS WheaAddHwErrorReportSectionDeviceDriver(
  WHEA_ERROR_HANDLE       ErrorHandle,
  ULONG                   SectionDataLength,
  PWHEA_DRIVER_BUFFER_SET BufferSet
);

Parameters

ErrorHandle

A WHEA_ERROR_HANDLE obtained from WheaCreateHwErrorReportDeviceDriver that specifies the packet that is being operated on.

SectionDataLength

A ULONG that specifies the length, in bytes, of the data to be added to the section.

BufferSet

A pointer to a WHEA_DRIVER_BUFFER_SET structure that will be populated with a set of buffers for the user to interact with.

Return value

Returns STATUS_SUCCESS or one of the following:

  • STATUS_INVALID_HANDLE: The ErrorHandle is invalid.
  • STATUS_DEVICE_REMOVED: The error source has been removed.
  • STATUS_INSUFFICIENT_RESOURCES: There is not enough space for the data.

Remarks

This routine can be called up to MaxSectionsPerReport times as specified in the WHEA_ERROR_SOURCE_CONFIGURATION_DEVICE_DRIVER structure supplied to WheaAddErrorSourceDeviceDriver.

Also see WheaHwErrorReportSetSectionNameDeviceDriver, which is a helper function for updating the FRUText.

For more info, see Using WHEA on Windows 10.

Requirements

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

See also

WheaCreateHwErrorReportDeviceDriver