Función WheaReportHwErrorDeviceDriver (ntddk.h)
Para notificar un error de hardware, el controlador llama a la función WheaReportHwErrorDeviceDriver .
Sintaxis
NTSTATUS WheaReportHwErrorDeviceDriver(
ULONG ErrorSourceId,
PDEVICE_OBJECT DeviceObject,
PUCHAR ErrorData,
ULONG ErrorDataLength,
LPGUID SectionTypeGuid,
WHEA_ERROR_SEVERITY ErrorSeverity,
LPSTR DeviceFriendlyName
);
Parámetros
ErrorSourceId
Identificador de origen del error WHEA proporcionado cuando llamó a la devolución de llamada _WHEA_ERROR_SOURCE_INITIALIZE_DEVICE_DRIVER .
DeviceObject
Puntero al objeto de dispositivo asociado a la condición de error.
ErrorData
Búfer que contiene los datos de error de hardware del controlador. Esta información es específica del hardware y no debe superar maxRawDataLength que el controlador proporcionó a WheaAddErrorSourceDeviceDriver .
ErrorDataLength
Valor de tipo ULONG que especifica el tamaño, en bytes, de los datos de error.
SectionTypeGuid
Especifica qué tipo de datos de error se notifican. Esto puede ser, pero no es necesario, uno de los GUID definidos en el Apéndice N de la especificación UEFI, en cuyo caso la información de error coincide con uno de los tipos de sección especificados. El autor de la llamada también puede crear un GUID y un formato de sección privada.
ErrorSeverity
Valor de enumeración de tipo WHEA_ERROR_SEVERITY especificar la gravedad de la condición de error.
DeviceFriendlyName
Cadena opcional de hasta 20 bytes de longitud (incluido terminador NULL) que describe el dispositivo asociado a la condición de error. Esta información se copia en el registro de error WHEA resultante y solo es informativo. La intención es colocar esta información en el registro de errores, por lo que cuando se crean registros de eventos, un consumidor puede solucionar fácilmente los problemas del dispositivo.
Valor devuelto
Este método de función devuelve STATUS_SUCCESS o un código de error adecuado.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 10, versión 1903 |
| Encabezado | ntddk.h |