WheaReportHwErrorDeviceDriver-Funktion (ntddk.h)
Um einen Hardwarefehler zu melden, ruft der Treiber die Funktion WheaReportHwErrorDeviceDriver auf.
Syntax
NTSTATUS WheaReportHwErrorDeviceDriver(
ULONG ErrorSourceId,
PDEVICE_OBJECT DeviceObject,
PUCHAR ErrorData,
ULONG ErrorDataLength,
LPGUID SectionTypeGuid,
WHEA_ERROR_SEVERITY ErrorSeverity,
LPSTR DeviceFriendlyName
);
Parameter
ErrorSourceId
Die Fehlerquellen-ID WHEA, die beim Aufruf des _WHEA_ERROR_SOURCE_INITIALIZE_DEVICE_DRIVER-Rückrufs angegeben wurde.
DeviceObject
Ein Zeiger auf das Geräteobjekt, das der Fehlerbedingung zugeordnet ist.
ErrorData
Der Puffer, der die Hardwarefehlerdaten des Treibers enthält. Diese Informationen sind hardwarespezifisch und dürfen den MaxRawDataLength-Wert nicht überschreiten, den der Treiber für WheaAddErrorSourceDeviceDriver bereitgestellt hat .
ErrorDataLength
Ein Wert vom Typ ULONG, der die Größe der Fehlerdaten in Bytes angibt.
SectionTypeGuid
Gibt an, welche Art von Fehlerdaten gemeldet werden. Dies kann eine der GUIDs sein, die im Anhang N der UEFI-Spezifikation definiert sind, ist jedoch nicht erforderlich. In diesem Fall entsprechen die Fehlerinformationen einem der angegebenen Abschnittstypen. Der Aufrufer kann auch eine GUID und ein privates Abschnittsformat erstellen.
ErrorSeverity
Ein Enumerationswert vom Typ WHEA_ERROR_SEVERITY , der den Schweregrad der Fehlerbedingung angibt.
DeviceFriendlyName
Eine optionale Zeichenfolge mit einer Länge von bis zu 20 Bytes (einschließlich NULL-Abschlusszeichen), die das gerät beschreibt, das der Fehlerbedingung zugeordnet ist. Diese Informationen werden in den resultierenden WHEA-Fehlerdatensatz kopiert und sind nur informationen. Die Absicht besteht darin, diese Informationen in den Fehlerdatensatz zu platzieren, sodass ein Consumer beim Erstellen von Ereignisprotokollen Geräteprobleme problemlos beheben kann.
Rückgabewert
Diese Funktionsmethode gibt STATUS_SUCCESS oder einen entsprechenden Fehlercode zurück.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 10, Version 1903 |
| Kopfzeile | ntddk.h |