DbgBreakPointWithStatus-Funktion (wdm.h)
Die DbgBreakPointWithStatus-Routine unterbricht den Kerneldebugger und sendet den Wert von Status an den Debugger.
Syntax
__analysis_noreturn NTSYSAPI VOID DbgBreakPointWithStatus(
[in] ULONG Status
);
Parameter
[in] Status
Gibt einen ULONG-Wert an, der an den Debugger gesendet wird (z. B. ein status Code oder eine Adresse).
Rückgabewert
Keine
Bemerkungen
DbgBreakPointWithStatus ist mit DbgBreakPoint identisch, mit Ausnahme der Statusmeldung .
Auf x86-Computern wird der Status-Parameter im eax-Register gespeichert. Auf Computern mit Registrierungsaufrufkonventionen wird Status im ersten Argumentregister gespeichert.
Diese Routine löst eine Ausnahme aus, die vom Kerneldebugger behandelt wird, wenn eine installiert ist. Andernfalls wird sie vom Debugsystem behandelt. Wenn ein Debugger nicht mit dem System verbunden ist, kann die Ausnahme standardmäßig behandelt werden.
Im Kernelmodus führt eine Unterbrechungsabnahme, die nicht behandelt wird, zu einer Fehlerüberprüfung. Sie können jedoch einen Debugger im Kernelmodus mit einem Zielcomputer verbinden, der nicht mehr reagiert und das Kerneldebuggen aktiviert ist. Weitere Informationen finden Sie unter Windows-Debuggen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar in Microsoft Windows 2000 und höher. |
| Zielplattform | Universell |
| Header | wdm.h (include Wdm.h, Ntddk.h) |
| Bibliothek | Ntdll.lib (Benutzermodus); NtosKrnl.lib (Kernelmodus) |
| DLL | NtosKrnl.exe |
| DDI-Complianceregeln | DebugBreakUsage(wdm), HwStorPortProhibitedDIs(storport) |