Функция 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 |