NtWaitForAlertByThreadId
Parkt den aufrufenden Thread, bis NtAlertThreadByThreadId ihn weckt — die Kernel-Seite von WaitOnAddress.
Prototyp
NTSTATUS NtWaitForAlertByThreadId( PVOID Address, PLARGE_INTEGER Timeout );
Argumente
| Name | Type | Dir | Description |
|---|---|---|---|
| Address | PVOID | in | Opaker Pointer als Hash-Schlüssel in der per-Prozess-Wait-Table — meist die Adresse des User-Mode-Sync-Wortes. |
| Timeout | PLARGE_INTEGER | in | Optionales 100-ns-Intervall. Negativ = relatives Timeout. NULL = unendlich warten. Liefert STATUS_TIMEOUT bei Ablauf. |
Syscall-IDs pro Windows-Version
| Windows-Version | Syscall-ID | Build |
|---|---|---|
| Win10 1507 | 0x1B3 | win10-1507 |
| Win10 1607 | 0x1BC | win10-1607 |
| Win10 1703 | 0x1C2 | win10-1703 |
| Win10 1709 | 0x1C6 | win10-1709 |
| Win10 1803 | 0x1C8 | win10-1803 |
| Win10 1809 | 0x1C9 | win10-1809 |
| Win10 1903 | 0x1CA | win10-1903 |
| Win10 1909 | 0x1CA | win10-1909 |
| Win10 2004 | 0x1D0 | win10-2004 |
| Win10 20H2 | 0x1D0 | win10-20h2 |
| Win10 21H1 | 0x1D0 | win10-21h1 |
| Win10 21H2 | 0x1D2 | win10-21h2 |
| Win10 22H2 | 0x1D2 | win10-22h2 |
| Win11 21H2 | 0x1DC | win11-21h2 |
| Win11 22H2 | 0x1E0 | win11-22h2 |
| Win11 23H2 | 0x1E0 | win11-23h2 |
| Win11 24H2 | 0x1E3 | win11-24h2 |
| Server 2016 | 0x1BC | winserver-2016 |
| Server 2019 | 0x1C9 | winserver-2019 |
| Server 2022 | 0x1D8 | winserver-2022 |
| Server 2025 | 0x1E3 | winserver-2025 |
Kernel-Modul
Verwandte APIs
Syscall-Stub
4C 8B D1 mov r10, rcx B8 E3 01 00 00 mov eax, 0x1E3 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
Undokumentierte Hinweise
Gegenstück zu `NtAlertThreadByThreadId`. Das `Address`-Argument wird vom Kernel *nicht* dereferenziert — es ist nur ein Hash-Schlüssel, der in die Wait-Table des EPROCESS (KiWaitChainList / RtlpHashAddress) gehasht wird. Wenn `NtAlertThreadByThreadId` mit der passenden TID aufgerufen wird, durchsucht der Kernel den Bucket, findet den passenden Thread und signalisiert ihn. Das adress-basierte Hashing ermöglicht die billige, objektlose Semantik von `WaitOnAddress`. Der SSN-Bereich (0x1B3 → 0x1E3) gehört zu den volatilsten in ntoskrnl — er verschiebt sich fast bei jedem Feature-Update, weil er am Ende der SST sitzt und die Tabelle dahinter wächst.
Häufige Malware-Nutzung
Genutzt von modernen Sleep-Mask-Implementierungen (Ekko-artig und Nachfolger), die eine Wait-Primitive *ohne* Event-/Mutex-Objekt-Backing möchten. Den schlafenden Beacon-Thread mit langem Timeout in diesem Syscall parken; mit `NtAlertThreadByThreadId` wecken, wenn Arbeit kommt. Kein `\BaseNamedObjects\…`-Eintrag, kein Handle in der Handle-View von System Informer, kein `Microsoft-Windows-Kernel-Object`-ETW-Event für Erzeugung. Kombiniert mit `WaitOnAddress`-artigem Polling auf ein Status-Wort kann sich der Implant als jeder moderne Win32-Prozess mit SRWLOCK oder den neuen std::mutex-Internals tarnen. Die legitime Last macht es zum schlechten Primärziel — und damit für Autoren attraktiv.
Erkennungsmöglichkeiten
Microsoft-Windows-Threat-Intelligence emittiert kein Per-Call-Event. Die einzig realistische Anomalie ist *Frequenz × Kontext*: ein Thread, der die meiste Zeit in `NtWaitForAlertByThreadId` mit nicht-NULL relativem Timeout verbringt, in einem Prozess mit Netzwerk-Egress, RX-only-Mapping, gestartet von einem Child von explorer.exe oder einer Office-App. Memory-Scanner (Moneta, Hunt-Sleeping-Beacons) finden die umliegende RX-Region; der Syscall ist nur Kolorit. EDRs flaggen mitunter ungewöhnliche Call-Site-Muster (Alert/Wait aus Nicht-System-DLL), aber False-Positive-Raten sind hoch, weil moderne C++-Runtimes denselben Pfad nehmen.
Direkte Syscall-Beispiele
cWaitOnAddress-style park
// Park a worker thread until a partner calls NtAlertThreadByThreadId
// with our TID. No event handle ever exists.
typedef NTSTATUS(NTAPI* fnWait)(PVOID, PLARGE_INTEGER);
void ParkWorker(volatile LONG* statusWord, ULONGLONG ns100) {
HMODULE n = GetModuleHandleA("ntdll.dll");
fnWait p = (fnWait)GetProcAddress(n, "NtWaitForAlertByThreadId");
LARGE_INTEGER t;
t.QuadPart = -(LONGLONG)ns100; // relative timeout
p((PVOID)statusWord, &t);
}asmx64 direct stub (Win11 24H2 SSN)
; SSN 0x1E3 on win11-24h2 / winserver-2025. Moves on nearly every feature update.
NtWaitForAlertByThreadId PROC
mov r10, rcx
mov eax, 1E3h
syscall
ret
NtWaitForAlertByThreadId ENDPrustSleep-mask park with timeout
// Park between beacon cycles using the address of a status word as hash key.
use windows_sys::Win32::System::LibraryLoader::{GetModuleHandleA, GetProcAddress};
type NtWaitForAlertByThreadId = unsafe extern "system" fn(addr: *mut u8, to: *mut i64) -> i32;
pub unsafe fn park(status: *mut u32, hundred_ns: i64) -> i32 {
let n = GetModuleHandleA(b"ntdll.dll\0".as_ptr());
let addr = GetProcAddress(n, b"NtWaitForAlertByThreadId\0".as_ptr()).unwrap();
let f: NtWaitForAlertByThreadId = std::mem::transmute(addr);
let mut t: i64 = -hundred_ns;
f(status as *mut u8, &mut t)
}MITRE ATT&CK-Mappings
Last verified: 2026-05-20