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 de erro WHEA fornecida quando chamou o retorno de chamada _WHEA_ERROR_SOURCE_INITIALIZE_DEVICE_DRIVER.
DeviceObject
Um ponteiro para o objeto do 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 de hardware e não devem exceder o MaxRawDataLength que o driver forneceu para WheaAddErrorSourceDeviceDriver.
ErrorDataLength
Um valor do tipo ULONG especificando 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 do de 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 o 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 somente 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 facilmente problemas do dispositivo.
Valor de retorno
Esse método de função retorna STATUS_SUCCESS ou um código de erro apropriado.
Requisitos
Requisito | Valor |
---|---|
de cliente com suporte mínimo | Windows 10, versão 1903 |
cabeçalho | ntddk.h |