NtWaitForKeyedEvent
Blockiert den aufrufenden Thread auf einem Keyed Event, bis ein anderer Thread dasselbe (Event, Key)-Paar freigibt.
Prototyp
NTSTATUS NtWaitForKeyedEvent( HANDLE KeyedEventHandle, PVOID Key, BOOLEAN Alertable, PLARGE_INTEGER Timeout );
Argumente
| Name | Type | Dir | Description |
|---|---|---|---|
| KeyedEventHandle | HANDLE | in | Handle auf ein Keyed Event. NULL nutzt den Per-Prozess-Default unter \KernelObjects\CritSecOutOfMemoryEvent. |
| Key | PVOID | in | Rendezvous-Wert in Zeigergröße. Muss natürlich ausgerichtet sein (Low-Bit Null). Konventionell die Adresse der Critical Section / des Lock-Wortes. |
| Alertable | BOOLEAN | in | TRUE macht das Warten durch User-Mode-APCs unterbrechbar; bei Lock-Primitiven fast immer FALSE. |
| Timeout | PLARGE_INTEGER | in | Optionales Timeout (100-ns-Einheiten, negativ = relativ). NULL = unbegrenzt warten. Liefert bei Ablauf STATUS_TIMEOUT. |
Syscall-IDs pro Windows-Version
| Windows-Version | Syscall-ID | Build |
|---|---|---|
| Win10 1507 | 0x1B5 | win10-1507 |
| Win10 1607 | 0x1BE | win10-1607 |
| Win10 1703 | 0x1C4 | win10-1703 |
| Win10 1709 | 0x1C8 | win10-1709 |
| Win10 1803 | 0x1CA | win10-1803 |
| Win10 1809 | 0x1CB | win10-1809 |
| Win10 1903 | 0x1CC | win10-1903 |
| Win10 1909 | 0x1CC | win10-1909 |
| Win10 2004 | 0x1D2 | win10-2004 |
| Win10 20H2 | 0x1D2 | win10-20h2 |
| Win10 21H1 | 0x1D2 | win10-21h1 |
| Win10 21H2 | 0x1D4 | win10-21h2 |
| Win10 22H2 | 0x1D4 | win10-22h2 |
| Win11 21H2 | 0x1DE | win11-21h2 |
| Win11 22H2 | 0x1E2 | win11-22h2 |
| Win11 23H2 | 0x1E2 | win11-23h2 |
| Win11 24H2 | 0x1E5 | win11-24h2 |
| Server 2016 | 0x1BE | winserver-2016 |
| Server 2019 | 0x1CB | winserver-2019 |
| Server 2022 | 0x1DA | winserver-2022 |
| Server 2025 | 0x1E5 | winserver-2025 |
Kernel-Modul
Verwandte APIs
Syscall-Stub
4C 8B D1 mov r10, rcx B8 E5 01 00 00 mov eax, 0x1E5 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
Die Wait-Hälfte des Keyed-Event-Paares. Intern von `ntdll!RtlEnterCriticalSection` als **Low-Memory-Fallback** verwendet, wenn die Contention einer Critical Section normalerweise das Allokieren eines Event-Objekts erfordern würde und der Pool erschöpft ist. Auf diesem Pfad übergibt `ntdll.dll` `peb->KeyedEventHandle` (das globale `CritSecOutOfMemoryEvent`) und nutzt die Adresse des `LockSemaphore`-Felds der Critical Section als Key — so kann jeder konkurrierende Thread im System ein einziges globales Keyed Event teilen. `NtWaitForKeyedEvent` ist außerdem eine von zwei Primitiven hinter `WaitOnAddress` (die andere ist `KeWaitForSingleObject` auf einem Thread-lokalen Event); auf modernen Builds ist `WaitOnAddress` der empfohlene User-Mode-Einstieg.
Häufige Malware-Nutzung
Bescheidenes Signal. Sleep-Obfuscation-Designs, die eine Sync-Primitive ohne benanntes Kernel-Objekt wollen, paaren `NtWaitForKeyedEvent` (im schlafenden Thread) mit `NtReleaseKeyedEvent` (in einem Wakeup-Timer-ROP-Gadget oder APC). Da das globale Handle in jedem Prozess bereits offen ist, kommt das gesamte Schema ohne neu erzeugte Handles aus — primitive Sandboxes, die Handle-Tables nach frisch erzeugten Events / Semaphoren scannen, werden umgangen. Die Ekko-Familie und mehrere publizierte Sleep-Mask-Demos bauen darauf. Bewusster direkter Aufruf von `NtWaitForKeyedEvent` aus einem Nicht-System-Binary außerhalb dieses Musters ist eher ein Hinweis auf eine eigene Lock-Implementierung als ein Malware-Signal.
Erkennungsmöglichkeiten
Gleiche Lage wie `NtCreateKeyedEvent`: keine nützliche ETW- oder Sysmon-Oberfläche. Der einzige sinnvolle Blue-Team-Winkel ist *verhaltensbasiert* — ein Thread, der ungewöhnlich lange in `NtWaitForKeyedEvent` auf dem globalen Handle hängt, während sein Modul in unbacked / nur RX-Speicher lebt (typisch für sleep-gemaskte Beacons), ist verdächtig. ETW Threat Intelligence + Memory-Region-Introspektion (z. B. `MemoryWorkingSetExInformation` mit `MEMORY_REGION_PRIVATE`-Seiten) ist aussagekräftiger als das Tracen des Syscalls selbst.
Direkte Syscall-Beispiele
asmx64 direct stub (Win11 24H2)
; Direct syscall stub for NtWaitForKeyedEvent (SSN 0x1E5 on Win11 24H2)
NtWaitForKeyedEvent PROC
mov r10, rcx ; KeyedEventHandle
mov eax, 1E5h ; SSN — drifts per build
syscall
ret
NtWaitForKeyedEvent ENDPcCritical-section low-memory fallback (illustrative)
// Mirrors what ntdll!RtlpWaitOnCriticalSection does in the out-of-pool path:
// every contending thread parks on the global keyed event using the address
// of the critical section's LockSemaphore slot as the rendezvous key.
#include <windows.h>
#include <winternl.h>
typedef NTSTATUS (NTAPI *pNtWaitForKeyedEvent)(
HANDLE, PVOID, BOOLEAN, PLARGE_INTEGER);
static pNtWaitForKeyedEvent g_wait;
void ParkOnLockWord(volatile void **lockSlot) {
if (!g_wait) {
g_wait = (pNtWaitForKeyedEvent)GetProcAddress(
GetModuleHandleA("ntdll.dll"), "NtWaitForKeyedEvent");
}
// NULL handle ⇒ kernel substitutes peb->KeyedEventHandle = global event.
g_wait(NULL, (PVOID)lockSlot, FALSE, NULL);
}cModern equivalent — WaitOnAddress (recommended)
// Microsoft's blessed user-mode primitive for the same pattern.
#include <windows.h>
#include <synchapi.h>
#pragma comment(lib, "Synchronization.lib")
void WaitForLockChange(volatile LONG *lock, LONG expected) {
WaitOnAddress((volatile VOID*)lock, &expected, sizeof(expected), INFINITE);
}MITRE ATT&CK-Mappings
Last verified: 2026-05-20