IddCxReportCriticalError-Funktion (iddcx.h)

IddCxReportCriticalError ist eine Betriebssystemrückruffunktion, 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 übergeben nullptr.

pInArgs

Zeiger auf eine IDARG_IN_REPORTCRITICALERROR-Struktur , die den Fehlercode des kritischen Fehlers enthält.

Rückgabewert

Wenn die Routine erfolgreich ist, kehrt sie nie zum Treiber zurück, da der Treiberprozess beendet wird.

Hinweise

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

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

Wenn ein Speicherabbild im Benutzermodus generiert wird, sollte der Treiber alle nützlichen Debuginformationen im Stapel der Funktion platzieren, die IddCxCriticalError aufgerufen hat.

Anforderungen

Weitere Informationen

IDARG_IN_REPORTCRITICALERROR