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
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 10 |
| Kopfzeile | iddcx.h |