> Windows Syscalls
ntoskrnl.exeT1027T1106

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

NameTypeDirDescription
KeyedEventHandleHANDLEinHandle auf ein Keyed Event. NULL nutzt den Per-Prozess-Default unter \KernelObjects\CritSecOutOfMemoryEvent.
KeyPVOIDinRendezvous-Wert in Zeigergröße. Muss natürlich ausgerichtet sein (Low-Bit Null). Konventionell die Adresse der Critical Section / des Lock-Wortes.
AlertableBOOLEANinTRUE macht das Warten durch User-Mode-APCs unterbrechbar; bei Lock-Primitiven fast immer FALSE.
TimeoutPLARGE_INTEGERinOptionales Timeout (100-ns-Einheiten, negativ = relativ). NULL = unbegrenzt warten. Liefert bei Ablauf STATUS_TIMEOUT.

Syscall-IDs pro Windows-Version

Windows-VersionSyscall-IDBuild
Win10 15070x1B5win10-1507
Win10 16070x1BEwin10-1607
Win10 17030x1C4win10-1703
Win10 17090x1C8win10-1709
Win10 18030x1CAwin10-1803
Win10 18090x1CBwin10-1809
Win10 19030x1CCwin10-1903
Win10 19090x1CCwin10-1909
Win10 20040x1D2win10-2004
Win10 20H20x1D2win10-20h2
Win10 21H10x1D2win10-21h1
Win10 21H20x1D4win10-21h2
Win10 22H20x1D4win10-22h2
Win11 21H20x1DEwin11-21h2
Win11 22H20x1E2win11-22h2
Win11 23H20x1E2win11-23h2
Win11 24H20x1E5win11-24h2
Server 20160x1BEwinserver-2016
Server 20190x1CBwinserver-2019
Server 20220x1DAwinserver-2022
Server 20250x1E5winserver-2025

Kernel-Modul

ntoskrnl.exeNtWaitForKeyedEvent

Verwandte APIs

NtCreateKeyedEventNtOpenKeyedEventNtReleaseKeyedEventWaitOnAddressWakeByAddressSingleRtlEnterCriticalSection

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.

Erkennungs­mö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 ENDP

cCritical-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