Funzione WheaReportHwErrorDeviceDriver (ntddk.h)
Per segnalare un errore hardware, il driver chiama la funzione WheaReportHwErrorDeviceDriver.
Sintassi
NTSTATUS WheaReportHwErrorDeviceDriver(
ULONG ErrorSourceId,
PDEVICE_OBJECT DeviceObject,
PUCHAR ErrorData,
ULONG ErrorDataLength,
LPGUID SectionTypeGuid,
WHEA_ERROR_SEVERITY ErrorSeverity,
LPSTR DeviceFriendlyName
);
Parametri
ErrorSourceId
L'ID di origine dell'errore WHEA specificato quando ha chiamato il callback _WHEA_ERROR_SOURCE_INITIALIZE_DEVICE_DRIVER.
DeviceObject
Puntatore all'oggetto dispositivo associato alla condizione di errore.
ErrorData
Buffer contenente i dati di errore hardware del driver. Queste informazioni sono specifiche dell'hardware e non devono superare il MaxRawDataLength fornito al driver per WheaAddErrorSourceDeviceDriver .
ErrorDataLength
Valore di tipo ULONG che specifica le dimensioni, in byte, dei dati di errore.
SectionTypeGuid
Specifica il tipo di dati di errore segnalati. Può essere, ma non è necessario, uno dei GUID definiti nell'Appendice N della specifica UEFI , nel qual caso le informazioni sull'errore corrispondono a uno dei tipi di sezione specificati. Il chiamante può anche creare un GUID e un formato di sezione privata.
ErrorSeverity
Valore di enumerazione di tipo WHEA_ERROR_SEVERITY che specifica la gravità della condizione di errore.
DeviceFriendlyName
Stringa facoltativa con lunghezza massima di 20 byte (incluso il carattere di terminazione NULL) che descrive il dispositivo associato alla condizione di errore. Queste informazioni vengono copiate nel record di errore WHEA risultante e sono solo informative. Lo scopo è inserire queste informazioni nel record di errore in modo che quando i registri eventi vengono creati un consumer può facilmente risolvere i problemi del dispositivo.
Valore restituito
Questo metodo di funzione restituisce STATUS_SUCCESS o un codice di errore appropriato.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Windows 10, versione 1903 |
| intestazione | ntddk.h |