IddCxReportCriticalError-Funktion (iddcx.h)

Artikel
02/07/2025

IddCxReportCriticalError ist eine Rückruffunktion des Betriebssystems, die von einem indirekten Anzeigetreiber (IDD) aufgerufen wird, um einen kritischen Fehler zu melden.

Syntax

NTSTATUS IddCxReportCriticalError(
  IDDCX_ADAPTER                      AdapterObject,
  const IDARG_IN_REPORTCRITICALERROR *pInArgs
);

Parameter

AdapterObject

Ein IDDCX_ADAPTER Objekt des Adapters, auf dem der kritische Fehler aufgetreten ist. Wenn der Fehler aufgetreten ist, bevor ein IDDCX_ADAPTER erstellt wurde, sollte die IDD nullptrübergeben.

pInArgs

Zeigen Sie auf eine IDARG_IN_REPORTCRITICALERROR Struktur, die den Fehlercode des kritischen Fehlers enthält.

Rückgabewert

Wenn die Routine erfolgreich ist, wird sie nie an den Treiber zurückgegeben, da der Treiberprozess beendet wird.

Bemerkungen

Wenn eine IDD IddCxCriticalErroraufruft, führt das Betriebssystem folgende Aktionen aus:

Fehlerüberprüfung des Treibers mit dem folgenden Bugcheckcode: (pInArgs->MajorErrorCode+0x100 << 8) + pInArgs->MinorErrorCode. Es wird empfohlen, dass der Treiber eine eindeutige Kombination aus einem wichtigen Code und Nebencode verwendet, damit diese Fälle in Abstürze und Watson-Berichten identifiziert werden können.
Beenden Sie den Treiberprozess, und starten Sie den Neustart gemäß der UMDF-Treiberneustartrichtlinie.
Wenn der Anrufer eine Remote-IDD ist, trennen Sie die Benutzersitzung.

Wenn ein Speicherabbild für den Benutzermodus generiert wird, sollte der Treiber alle nützlichen Debuginformationen auf dem Stapel der Funktion platzieren, die IddCxCriticalErroraufgerufen hat.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 10
Header-	iddcx.h

Siehe auch

IDARG_IN_REPORTCRITICALERROR

Freigeben über