WheaReportHwErrorDeviceDriver-Funktion (ntddk.h)
Um einen Hardwarefehler zu melden, ruft der Treiber die WheaReportHwErrorDeviceDriver-Funktion 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 Aufrufen des _WHEA_ERROR_SOURCE_INITIALIZE_DEVICE_DRIVER Rückrufs bereitgestellt 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, den der Treiber WheaAddErrorSourceDeviceDriver bereitgestellt hat, nicht überschreiten.
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, aber nicht erforderlich sein, eine der GUIDs, die im Anhang N der UEFI-Spezifikationdefiniert sind. In diesem Fall entsprechen die Fehlerinformationen einem der angegebenen Abschnittstypen. Der Aufrufer kann auch ein GUID- und privates Abschnittsformat erstellen.
ErrorSeverity
Ein Enumerationswert vom Typ WHEA_ERROR_SEVERITY angeben, der den Schweregrad der Fehlerbedingung angibt.
DeviceFriendlyName
Eine optionale Zeichenfolge mit einer Länge von bis zu 20 Bytes (einschließlich NULL-Terminator), die das gerät beschreibt, das der Fehlerbedingung zugeordnet ist. Diese Informationen werden in den resultierenden WHEA-Fehlerdatensatz kopiert und sind nur informational. Die Absicht besteht darin, diese Informationen in den Fehlerdatensatz zu setzen, sodass ein Verbraucher problemlos Geräteprobleme beheben kann, wenn Ereignisprotokolle erstellt werden.
Rückgabewert
Diese Funktionsmethode gibt STATUS_SUCCESS oder einen geeigneten Fehlercode zurück.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 10, Version 1903 |
| Header- | ntddk.h |