Freigeben über


DbgBreakPointWithStatus-Funktion (wdm.h)

Die DbgBreakPointWithStatus Routine unterbricht in den Kerneldebugger und sendet den Wert 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. einen Statuscode oder eine Adresse).

Rückgabewert

Nichts

Bemerkungen

DbgBreakPointWithStatus- ist identisch mit DbgBreakPoint-, mit Ausnahme der Status Nachricht.

Auf x86-Computern wird der parameter Status im eax register gespeichert. Auf Computern, auf denen Aufrufkonventionen registriert sind, 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 nicht behandelte Unterbrechungs ausnahme zu einer Fehlerüberprüfung. Sie können jedoch einen Kernelmodusdebugger mit einem Zielcomputer verbinden, der nicht mehr reagiert hat und das Kerneldebugging aktiviert ist. Weitere Informationen finden Sie unter Windows Debugging.

Anforderungen

Anforderung Wert
mindestens unterstützte Client- Verfügbar in Microsoft Windows 2000 und höher.
Zielplattform- Universal
Header- wdm.h (include Wdm.h, Ntddk.h)
Library Ntdll.lib (Benutzermodus); NtosKrnl.lib (Kernelmodus)
DLL- NtosKrnl.exe
DDI-Complianceregeln DebugBreakUsage(wdm), HwStorPortProhibitedDIs(storport)

Siehe auch

DbgBreakPoint-

KdBreakPoint-

KdBreakPointWithStatus-