WheaAddErrorSourceDeviceDriver-Funktion (ntddk.h)

Artikel
02/07/2025

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 NULL sein.

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 vorzuverteilt werden sollen. Weitere Informationen finden Sie in den Hinweisen.

Rückgabewert

Diese Funktionsmethode gibt STATUS_SUCCESS zurück, wenn die Fehlerquelle hinzugefügt wird. Andernfalls kann eine der folgenden Elemente zurückgegeben werden:

STATUS_INVALID_PARAMETER: Die Konfiguration fehlt beim Initialisieren und/oder Aufheben der Initialisierung von Rückrufzeigern.
STATUS_INVALID_PARAMETER_2: Eine Konfiguration mit einer ungültigen Version wurde übermittelt.
STATUS_INSUFFICIENT_RESOURCES: WHEA konnte keinen Speicherplatz für die Fehlerquelle und die zugehörigen Datensätze zuordnen.

Bemerkungen

Um eine Fehlerquelle zu entfernen, ruft der Treiber WheaRemoveErrorSourceDeviceDriverauf.

WHEA kann Speicher für Fehler vorzuweisen, die bei hoher IRQL gemeldet werden (d. h. im Kontext eines Geräteunterbruchs). Für fehlerquellen, die bei PASSIVE_LEVEL gemeldet wurden, ist die Vorlastung nicht erforderlich, aber wenn der Gerätetreiber Fehler für seine Fehlerquelle bei DISPATCH_LEVEL oder höher meldet, müssen Fehlerdatensätze vorab zugewiesen werden.

Weitere Informationen finden Sie unter Verwenden von WHEA unter Windows 10.