Функция 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 или соответствующий код ошибки.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 10 версии 1903 |
| Верхняя часть | ntddk.h |