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 fornito 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 maxRawDataLength che il driver fornito a 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. Questo 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 formato GUID e sezione privata.
ErrorSeverity
Valore di enumerazione di tipo WHEA_ERROR_SEVERITY che specifica la gravità della condizione di errore.
DeviceFriendlyName
Stringa facoltativa fino a 20 byte di lunghezza (incluso il terminatore NULL) che descrive il dispositivo associato alla condizione di errore. Queste informazioni vengono copiate nel record di errore WHEA risultante ed è solo informativo. La finalità consiste nel inserire queste informazioni nel record di errore in modo che quando i log eventi vengono creati un consumer può risolvere facilmente i problemi del dispositivo.
Valore restituito
Questo metodo di funzione restituisce STATUS_SUCCESS o un codice di errore appropriato.
Requisiti
Requisito | Valore |
---|---|
Client minimo supportato | Windows 10, versione 1903 |
Intestazione | ntddk.h |