> Windows Syscalls
ntoskrnl.exeT1622T1106

NtDebugContinue

Reprend l'exécution d'un thread débogué après un événement, avec un NTSTATUS de continuation.

Prototype

NTSTATUS NtDebugContinue(
  HANDLE     DebugObjectHandle,
  PCLIENT_ID DebuggeeId,
  NTSTATUS   ContinueStatus
);

Arguments

NameTypeDirDescription
DebugObjectHandleHANDLEinHandle vers le debug object qui a délivré l'événement original.
DebuggeeIdPCLIENT_IDinClientId (UniqueProcess + UniqueThread) du thread débogué à reprendre — généralement copié depuis DBGUI_WAIT_STATE_CHANGE.AppClientId.
ContinueStatusNTSTATUSinDBG_CONTINUE (0x00010002), DBG_EXCEPTION_NOT_HANDLED (0x80010001) ou DBG_REPLY_LATER.

IDs de syscalls par version de Windows

Version de WindowsID de syscallBuild
Win10 15070xC0win10-1507
Win10 16070xC3win10-1607
Win10 17030xC6win10-1703
Win10 17090xC7win10-1709
Win10 18030xC8win10-1803
Win10 18090xC9win10-1809
Win10 19030xCAwin10-1903
Win10 19090xCAwin10-1909
Win10 20040xCEwin10-2004
Win10 20H20xCEwin10-20h2
Win10 21H10xCEwin10-21h1
Win10 21H20xCFwin10-21h2
Win10 22H20xCFwin10-22h2
Win11 21H20xD4win11-21h2
Win11 22H20xD5win11-22h2
Win11 23H20xD5win11-23h2
Win11 24H20xD7win11-24h2
Server 20160xC3winserver-2016
Server 20190xC9winserver-2019
Server 20220xD3winserver-2022
Server 20250xD7winserver-2025

Module noyau

ntoskrnl.exeNtDebugContinue

APIs liées

ContinueDebugEventNtWaitForDebugEventNtCreateDebugObjectNtDebugActiveProcessNtRemoveProcessDebugDBG_CONTINUEDBG_EXCEPTION_NOT_HANDLEDDBG_REPLY_LATER

Stub du syscall

4C 8B D1            mov r10, rcx
B8 D7 00 00 00      mov eax, 0xD7      ; Win11 24H2 SSN
F6 04 25 08 03 FE 7F 01   test byte ptr [0x7FFE0308], 1
75 03               jne short +3
0F 05               syscall
C3                  ret
CD 2E               int 2Eh
C3                  ret

Notes non documentées

Le complément de `NtWaitForDebugEvent` — chaque événement renvoyé par l'attente doit être acquitté ou le thread débogué reste gelé indéfiniment. `DBG_CONTINUE` dit « j'ai géré ceci, aucune exception ne s'échappe vers le SEH du débogué » ; `DBG_EXCEPTION_NOT_HANDLED` dit « laissez SEH dérouler dans le débogué » ; le moins connu `DBG_REPLY_LATER` (Win10 1607+) diffère l'ack pour qu'un débogueur puisse collecter plusieurs événements sans geler les threads intermédiaires. Le paramètre `ClientId` est ce qui rend cela à granularité thread — un débogué multi-thread peut avoir un thread repris pendant que d'autres restent à l'arrêt.

Usage courant par les malwares

Toujours apparié à `NtWaitForDebugEvent`. Dans le pattern anti-attach par auto-débogage, la boucle répond systématiquement `DBG_CONTINUE` à *chaque* exception, rendant le débogué imperméable aux astuces standards d'analyste (`int 3` planté dans le code, `__debugbreak`, `RaiseException(0x80000003)`) — celles-ci remonteraient normalement dans un débogueur externe attaché mais sont ici avalées silencieusement par l'auto-débogueur. Une variante plus sophistiquée inspecte l'événement, vérifie si l'exception est l'une que l'implant lui-même a levée (ex. un `int 3` stégano dont l'adresse correspond à un anti-debug connu) et répond sélectivement `DBG_CONTINUE` vs `DBG_EXCEPTION_NOT_HANDLED` pour faire croire au débogué qu'aucun débogueur n'est présent (le chemin `IsDebuggerPresent`/PEB.BeingDebugged reste propre car le débogueur *externe* ne s'est jamais attaché).

Opportunités de détection

`NtDebugContinue` seul est bruyant — tout débogueur en cours d'exécution l'appelle constamment. La valeur de détection est dans le contexte parent : un processus qui a à la fois `EPROCESS.DebugPort != NULL` et est lui-même le débogueur (son thread détenant le handle du debug object), où le débogué est *lui-même* ou un enfant. Combiné à `NtCreateDebugObject` + `NtDebugActiveProcess(NtCurrentProcess())` c'est la signature anti-attach par auto-débogage. ETW Microsoft-Windows-Kernel-Process fait remonter les transitions de debug port.

Exemples de syscalls directs

cContinue every event silently

// Inside the self-debug loop, after NtWaitForDebugEvent returned `sc`.
NTSTATUS status = (sc.NewState == DbgExceptionStateChange)
    ? DBG_CONTINUE                  // swallow ALL exceptions silently
    : DBG_CONTINUE;                 // and pass non-exception events through

NtDebugContinue(hDbg, &sc.AppClientId, status);

cSelective forwarding (smarter anti-debug)

// Only swallow our own planted int3s; let other exceptions surface to the debuggee.
if (sc.NewState == DbgExceptionStateChange) {
    PVOID pc = (PVOID)sc.StateInfo.Exception.ExceptionRecord.ExceptionAddress;
    NTSTATUS code = sc.StateInfo.Exception.ExceptionRecord.ExceptionCode;

    NTSTATUS reply;
    if (code == STATUS_BREAKPOINT && IsOurAntiDebugProbe(pc)) {
        reply = DBG_CONTINUE;                  // hide it from any SEH check
    } else {
        reply = DBG_EXCEPTION_NOT_HANDLED;     // let the debuggee see/handle it
    }
    NtDebugContinue(hDbg, &sc.AppClientId, reply);
} else {
    NtDebugContinue(hDbg, &sc.AppClientId, DBG_CONTINUE);
}

asmx64 direct stub

; NtDebugContinue direct syscall (Win11 24H2 SSN 0xD7)
NtDebugContinue PROC
    mov  r10, rcx
    mov  eax, 0D7h
    syscall
    ret
NtDebugContinue ENDP

Mappings MITRE ATT&CK

Last verified: 2026-05-20