WheaAddErrorSourceDeviceDriver-Funktion (ntddk.h)
Ein Gerätetreiber ruft WheaAddErrorSourceDeviceDriver auf, um eine Fehlerquelle hinzuzufügen.
Syntax
NTSTATUS WheaAddErrorSourceDeviceDriver(
PVOID Context,
PWHEA_ERROR_SOURCE_CONFIGURATION_DEVICE_DRIVER Configuration,
ULONG NumberPreallocatedErrorReports
);
Parameter
Context
Ein optionaler Zeiger auf einen vom Aufrufer zugewiesenen Kontext. WHEA stellt den Kontext als Parameter für vom Treiber bereitgestellte Rückrufroutinen bereit. Kann den Wert NULL haben.
Configuration
Zeiger auf eine Struktur vom Typ WHEA_ERROR_SOURCE_CONFIGURATION_DEVICE_DRIVER , die eine Reihe von vom Treiber bereitgestellten Rückrufroutinen enthält.
NumberPreallocatedErrorReports
Ein Wert vom Typ ULONG, der die Anzahl der Datensätze angibt, die vorab zugeordnet werden sollen. Weitere Informationen finden Sie unter Hinweise.
Rückgabewert
Diese Funktionsmethode gibt STATUS_SUCCESS zurück, wenn die Fehlerquelle hinzugefügt wird. Andernfalls kann eine der folgenden Zurückgegeben werden:
- STATUS_INVALID_PARAMETER: Die Konfiguration fehlt, um Rückrufzeiger zu initialisieren und/oder zu initialisieren.
- STATUS_INVALID_PARAMETER_2: Eine Konfiguration mit einer ungültigen Version wurde übermittelt.
- STATUS_INSUFFICIENT_RESOURCES: WHEA konnte der Fehlerquelle und ihren Datensätzen keinen Speicherplatz zuweisen.
Hinweise
Um eine Fehlerquelle zu entfernen, ruft der Treiber WheaRemoveErrorSourceDeviceDriver auf.
WHEA kann Arbeitsspeicher vorab für Fehler zuweisen, die bei hoher IRQL-Höhe (d. h. im Kontext eines Geräteunterbrechungs) gemeldet werden. Für Fehlerquellen, die bei PASSIVE_LEVEL gemeldet werden, ist keine Vorablokalisierung erforderlich, aber wenn der Gerätetreiber Fehler für seine Fehlerquelle bei DISPATCH_LEVEL oder höher meldet, müssen Fehlerdatensätze vorab zugeordnet werden.
Weitere Informationen finden Sie unter Verwenden von WHEA auf Windows 10.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 10, Version 2004 |
| Kopfzeile | ntddk.h |