Функция 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, указанный при вызове обратного вызова _WHEA_ERROR_SOURCE_INITIALIZE_DEVICE_DRIVER .

DeviceObject

Указатель на объект устройства, связанный с условием ошибки.

ErrorData

Буфер, содержащий данные об ошибках оборудования драйвера. Эти сведения относятся к оборудованию и не должны превышать значение MaxRawDataLength, предоставленное драйвером для WheaAddErrorSourceDeviceDriver.

ErrorDataLength

Значение типа ULONG, указывающее размер данных об ошибке в байтах.

SectionTypeGuid

Указывает тип данных об ошибках, которые передаются. Это может быть один из идентификаторов GUID, определенных в приложении N спецификации UEFI. В этом случае сведения об ошибке соответствуют одному из указанных типов разделов. Вызывающий объект также может создать формат GUID и закрытого раздела.

ErrorSeverity

Значение перечисления типа WHEA_ERROR_SEVERITY , указывающее серьезность условия ошибки.

DeviceFriendlyName

Необязательная строка длиной до 20 байт (включая признак конца NULL), описывающая устройство, связанное с условием ошибки. Эти сведения копируются в итоговую запись об ошибке WHEA и являются только информационными. Цель состоит в том, чтобы поместить эти сведения в запись об ошибке, чтобы при создании журналов событий потребитель легко устранял проблемы с устройством.

Возвращаемое значение

Этот метод функции возвращает STATUS_SUCCESS или соответствующий код ошибки.

Требования

См. также раздел

WheaAddErrorSourceDeviceDriver

WheaRemoveErrorSourceDeviceDriver