Funzione DbgBreakPointWithStatus (wdm.h)
La routine DbgBreakPointWithStatus si interrompe nel debugger del kernel e invia il valore di Status al debugger.
Sintassi
__analysis_noreturn NTSYSAPI VOID DbgBreakPointWithStatus(
[in] ULONG Status
);
Parametri
[in] Status
Specifica un valore ULONG inviato al debugger, ad esempio un codice di stato o un indirizzo.
Valore restituito
nessuno
Osservazioni
DbgBreakPointWithStatus è identico a DbgBreakPoint, ad eccezione del messaggio Stato .
Nei computer x86 il parametro Status viene archiviato nel registro eax . Nei computer che dispongono di convenzioni di chiamata, lo stato viene archiviato nel primo registro degli argomenti.
Questa routine genera un'eccezione gestita dal debugger del kernel se ne viene installata una; in caso contrario, viene gestito dal sistema di debug. Se un debugger non è connesso al sistema, l'eccezione può essere gestita nel modo standard.
In modalità kernel, un'eccezione di interruzione non gestita causerà un controllo di bug. È tuttavia possibile connettere un debugger in modalità kernel a un computer di destinazione che ha interrotto la risposta e ha abilitato il debug del kernel. Per altre informazioni, vedere Debug di Windows.
Requisiti
Requisito | Valore |
---|---|
Client minimo supportato | Disponibile in Microsoft Windows 2000 e versioni successive. |
Piattaforma di destinazione | Universale |
Intestazione | wdm.h (include Wdm.h, Ntddk.h) |
Libreria | Ntdll.lib (modalità utente); NtosKrnl.lib (modalità kernel) |
DLL | NtosKrnl.exe |
Regole di conformità DDI | DebugBreakUsage(wdm), HwStorPortProhibitedDDDIs(storport) |