Função WheaReportHwErrorDeviceDriver (ntddk.h)
Para relatar um erro de hardware, o driver chama a função WheaReportHwErrorDeviceDriver .
Sintaxe
NTSTATUS WheaReportHwErrorDeviceDriver(
ULONG ErrorSourceId,
PDEVICE_OBJECT DeviceObject,
PUCHAR ErrorData,
ULONG ErrorDataLength,
LPGUID SectionTypeGuid,
WHEA_ERROR_SEVERITY ErrorSeverity,
LPSTR DeviceFriendlyName
);
Parâmetros
ErrorSourceId
A ID de origem do erro WHEA fornecida quando chamou o retorno de chamada _WHEA_ERROR_SOURCE_INITIALIZE_DEVICE_DRIVER .
DeviceObject
Um ponteiro para o objeto de dispositivo associado à condição de erro.
ErrorData
O buffer que contém os dados de erro de hardware do driver. Essas informações são específicas do hardware e não devem exceder o MaxRawDataLength que o driver forneceu para WheaAddErrorSourceDeviceDriver .
ErrorDataLength
Um valor do tipo ULONG que especifica o tamanho, em bytes, dos dados de erro.
SectionTypeGuid
Especifica que tipo de dados de erro estão sendo relatados. Isso pode ser, mas não é necessário, um dos GUIDs definidos no Apêndice N da Especificação uefi, nesse caso, as informações de erro correspondem a um dos tipos de seção especificados. O chamador também pode criar um GUID e um formato de seção privada.
ErrorSeverity
Um valor de enumeração do tipo WHEA_ERROR_SEVERITY especificando a gravidade da condição de erro.
DeviceFriendlyName
Uma cadeia de caracteres opcional de até 20 bytes de comprimento (incluindo terminador NULL) que descreve o dispositivo associado à condição de erro. Essas informações são copiadas para o registro de erro WHEA resultante e são apenas informativas. A intenção é colocar essas informações no registro de erro para que, quando os logs de eventos forem criados, um consumidor possa solucionar problemas de dispositivo facilmente.
Retornar valor
Esse método de função retorna STATUS_SUCCESS ou um código de erro apropriado.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 10, versão 1903 |
| Cabeçalho | ntddk.h |