DbgBreakPointWithStatus, fonction (wdm.h)
La routine DbgBreakPointWithStatus s’interrompt dans le débogueur de noyau et envoie la valeur Status au débogueur.
Syntaxe
__analysis_noreturn NTSYSAPI VOID DbgBreakPointWithStatus(
[in] ULONG Status
);
Paramètres
[in] Status
Spécifie une valeur ULONG envoyée au débogueur (par exemple, un code status ou une adresse).
Valeur de retour
None
Remarques
DbgBreakPointWithStatus est identique à DbgBreakPoint, à l’exception du message Status .
Sur les ordinateurs x86, le paramètre Status est stocké dans le registre eax . Sur les machines qui ont des conventions d’appel d’inscription, l’état est stocké dans le premier registre d’arguments.
Cette routine génère une exception qui est gérée par le débogueur de noyau si un autre est installé ; sinon, il est géré par le système de débogage. Si un débogueur n’est pas connecté au système, l’exception peut être gérée de manière standard.
En mode noyau, une exception d’arrêt qui n’est pas gérée entraîne un bogue case activée. Toutefois, vous pouvez connecter un débogueur en mode noyau à un ordinateur cible qui a cessé de répondre et dont le débogage du noyau est activé. Pour plus d’informations, consultez Débogage Windows.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Disponible dans Microsoft Windows 2000 et versions ultérieures. |
| Plateforme cible | Universal |
| En-tête | wdm.h (inclure Wdm.h, Ntddk.h) |
| Bibliothèque | Ntdll.lib (mode utilisateur) ; NtosKrnl.lib (mode noyau) |
| DLL | NtosKrnl.exe |
| Règles de conformité DDI | DebugBreakUsage(wdm),HwStorPortProhibitedDDIs(storport) |