NtGetContextThread
Récupère le contexte des registres CPU (structure CONTEXT) d'un thread suspendu.
Prototype
NTSTATUS NtGetContextThread( HANDLE ThreadHandle, PCONTEXT ThreadContext );
Arguments
| Name | Type | Dir | Description |
|---|---|---|---|
| ThreadHandle | HANDLE | in | Handle vers le thread cible. Requiert l'accès THREAD_GET_CONTEXT. |
| ThreadContext | PCONTEXT | in/out | Structure CONTEXT spécifique à l'architecture. ContextFlags (entrée) sélectionne les groupes de registres à retourner ; la structure doit être alignée sur 16 octets en x64. |
IDs de syscalls par version de Windows
| Version de Windows | ID de syscall | Build |
|---|---|---|
| Win10 1507 | 0xE3 | win10-1507 |
| Win10 1607 | 0xE6 | win10-1607 |
| Win10 1703 | 0xE9 | win10-1703 |
| Win10 1709 | 0xEA | win10-1709 |
| Win10 1803 | 0xEB | win10-1803 |
| Win10 1809 | 0xEC | win10-1809 |
| Win10 1903 | 0xED | win10-1903 |
| Win10 1909 | 0xED | win10-1909 |
| Win10 2004 | 0xF2 | win10-2004 |
| Win10 20H2 | 0xF2 | win10-20h2 |
| Win10 21H1 | 0xF2 | win10-21h1 |
| Win10 21H2 | 0xF3 | win10-21h2 |
| Win10 22H2 | 0xF3 | win10-22h2 |
| Win11 21H2 | 0xF8 | win11-21h2 |
| Win11 22H2 | 0xF9 | win11-22h2 |
| Win11 23H2 | 0xF9 | win11-23h2 |
| Win11 24H2 | 0xFB | win11-24h2 |
| Server 2016 | 0xE6 | winserver-2016 |
| Server 2019 | 0xEC | winserver-2019 |
| Server 2022 | 0xF7 | winserver-2022 |
| Server 2025 | 0xFB | winserver-2025 |
Module noyau
APIs liées
Stub du syscall
4C 8B D1 mov r10, rcx B8 FB 00 00 00 mov eax, 0xFB 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
La structure CONTEXT est spécifique à l'architecture et volumineuse : sur x64 elle fait 1232 octets (CONTEXT) plus une zone XSTATE étendue dont la taille dépend des fonctionnalités CPU activées (les enclaves AVX-512 peuvent la pousser au-delà de 2,5 Ko). Les appelants doivent définir ContextFlags avant l'appel — CONTEXT_CONTROL (Rip, Rsp, EFlags), CONTEXT_INTEGER (Rax..R15), CONTEXT_SEGMENTS, CONTEXT_DEBUG_REGISTERS (DR0..DR7), CONTEXT_FLOATING_POINT, CONTEXT_XSTATE. Le thread devrait être suspendu ; lire le contexte d'un thread en exécution renvoie un instantané qui peut être obsolète à l'arrivée.
Usage courant par les malwares
La moitié lecture de la primitive de détournement de thread : suspendre → obtenir le contexte → patcher Rip/Rsp → poser le contexte → reprendre. Aussi utilisé par du code anti-debug pour lire DR0–DR3 de ses propres threads et détecter les points d'arrêt matériels installés par un analyste (`if (ctx.Dr0 || ctx.Dr1 || ctx.Dr2 || ctx.Dr3) bail();`). Certaines sandbox marquent les threads avec des valeurs sentinelles dans des sélecteurs de segments inutilisés, et les packers les vérifient. Les BOF `inject` de Cobalt Strike, Sliver migrate, ScareCrow et la plupart des variantes Early Bird APC passent par là.
Opportunités de détection
Isolément, NtGetContextThread est d'un volume modéré — debuggers, runtime .NET, profilers et gestionnaires d'exception lisent tous le contexte. Les lectures inter-processus sur des cibles non débogées sont nettement plus rares ; corréler la télémétrie ETW Microsoft-Windows-Threat-Intelligence avec le contexte de relation entre processus (parent/enfant, signataire). La détection la plus actionnable est la *séquence* NtSuspendThread → NtGetContextThread → NtSetContextThread → NtResumeThread dans une fenêtre courte sur un thread distant.
Exemples de syscalls directs
cHardware-breakpoint anti-debug self-check
// Detect analyst-set DR0..DR3 on our own primary thread.
CONTEXT ctx = { .ContextFlags = CONTEXT_DEBUG_REGISTERS };
if (NT_SUCCESS(NtGetContextThread(NtCurrentThread(), &ctx))) {
if (ctx.Dr0 | ctx.Dr1 | ctx.Dr2 | ctx.Dr3) {
// Hardware breakpoint installed -> exit silently.
NtTerminateProcess(NtCurrentProcess(), 0);
}
}asmx64 stub (Win11 24H2)
NtGetContextThread PROC
mov r10, rcx ; ThreadHandle
mov eax, 0FBh ; Win11 24H2 SSN
syscall
ret
NtGetContextThread ENDPrustRead RIP of suspended thread
use windows_sys::Win32::System::Diagnostics::Debug::*;
unsafe fn read_rip(h_thread: isize) -> Option<u64> {
let mut ctx: CONTEXT = std::mem::zeroed();
ctx.ContextFlags = CONTEXT_CONTROL_AMD64; // RIP, RSP, SegCS, EFlags
// Direct-syscall wrapper omitted for brevity.
if nt_get_context_thread(h_thread, &mut ctx) >= 0 { Some(ctx.Rip) } else { None }
}Mappings MITRE ATT&CK
Last verified: 2026-05-20