> Windows Syscalls
ntoskrnl.exeT1027T1106

NtReleaseKeyedEvent

Despierta exactamente un hilo en espera del mismo par (keyed event, clave), bloqueando si aún no hay waiter presente.

Prototipo

NTSTATUS NtReleaseKeyedEvent(
  HANDLE         KeyedEventHandle,
  PVOID          Key,
  BOOLEAN        Alertable,
  PLARGE_INTEGER Timeout
);

Argumentos

NameTypeDirDescription
KeyedEventHandleHANDLEinHandle a un keyed event. NULL usa el predeterminado por proceso en \KernelObjects\CritSecOutOfMemoryEvent.
KeyPVOIDinValor de rendez-vous del tamaño de un puntero alineado naturalmente. Debe coincidir con la Key de exactamente un waiter; si no, la llamada misma bloquea.
AlertableBOOLEANinTRUE permite interrumpir la release por APC de user-mode mientras espera un waiter coincidente; casi siempre FALSE.
TimeoutPLARGE_INTEGERinTiempo de espera opcional para la espera implícita si no hay waiter coincidente (unidades de 100 ns, negativo = relativo). NULL = infinito.

IDs de syscalls por versión de Windows

Versión de WindowsID de syscallBuild
Win10 15070x154win10-1507
Win10 16070x15Bwin10-1607
Win10 17030x161win10-1703
Win10 17090x164win10-1709
Win10 18030x166win10-1803
Win10 18090x167win10-1809
Win10 19030x168win10-1903
Win10 19090x168win10-1909
Win10 20040x16Ewin10-2004
Win10 20H20x16Ewin10-20h2
Win10 21H10x16Ewin10-21h1
Win10 21H20x170win10-21h2
Win10 22H20x170win10-22h2
Win11 21H20x178win11-21h2
Win11 22H20x17Bwin11-22h2
Win11 23H20x17Bwin11-23h2
Win11 24H20x17Dwin11-24h2
Server 20160x15Bwinserver-2016
Server 20190x167winserver-2019
Server 20220x176winserver-2022
Server 20250x17Dwinserver-2025

Módulo del kernel

ntoskrnl.exeNtReleaseKeyedEvent

APIs relacionadas

NtCreateKeyedEventNtOpenKeyedEventNtWaitForKeyedEventWakeByAddressSingleWakeByAddressAllRtlLeaveCriticalSection

Stub del syscall

4C 8B D1            mov r10, rcx
B8 7D 01 00 00      mov eax, 0x17D
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

Notas no documentadas

La mitad wake del par keyed event, y famosamente *simétrica* a `NtWaitForKeyedEvent`: una release sin waiter coincidente bloquea al llamante hasta que aparezca un waiter, en lugar de descartar el wake como haría un event normal. Esto es lo que hace la primitiva correcta para la ruta out-of-pool de `RtlEnterCriticalSection` — releases y waits se autorregulan, así un único event global atiende contención ilimitada sin perder wakes. El handler de kernel es `ExpReleaseWaitForKeyedEvent` (un pequeño inverso de `ExpWaitForKeyedEvent`); ambos consultan la tabla hash por event que empareja tuplas `(process, key)`.

Uso común por malware

Espejo de `NtWaitForKeyedEvent`. En cadenas de obfuscación de sleep, este es el syscall que *despierta al beacon* tras que el sleep mask se haya desprotegido y descifrado. Algunos diseños lo invocan desde un APC entregado por un callback `NtSetTimer2`, otros desde un gadget ROP encadenado a un contexto falso — en cualquier caso, el handle global en el PEB significa que ningún nuevo objeto nombrado se toca. Fuera de ese patrón muy estrecho, las llamadas a `NtReleaseKeyedEvent` desde código no-Microsoft son prácticamente inexistentes.

Oportunidades de detección

Igual que `NtWaitForKeyedEvent` — no hay superficie ETW / Sysmon dirigida. Los ETW de introspección de memoria (eventos `AllocVm` / `ProtectVm` del proveedor `Microsoft-Windows-Threat-Intelligence`) captando un flip RW→RX en páginas privadas *inmediatamente seguido* por un hilo saliendo de `NtWaitForKeyedEvent` es una pista mucho más fuerte que trazar este syscall aislado.

Ejemplos de syscalls directos

asmx64 direct stub (Win11 24H2)

; Direct syscall stub for NtReleaseKeyedEvent (SSN 0x17D on Win11 24H2)
NtReleaseKeyedEvent PROC
    mov  r10, rcx          ; KeyedEventHandle
    mov  eax, 17Dh         ; SSN — drifts per build
    syscall
    ret
NtReleaseKeyedEvent ENDP

cWake a thread parked on the global keyed event

// Companion to the NtWaitForKeyedEvent low-memory critical-section example.
#include <windows.h>
#include <winternl.h>

typedef NTSTATUS (NTAPI *pNtReleaseKeyedEvent)(
    HANDLE, PVOID, BOOLEAN, PLARGE_INTEGER);

static pNtReleaseKeyedEvent g_release;

void WakeOnLockWord(volatile void **lockSlot) {
    if (!g_release) {
        g_release = (pNtReleaseKeyedEvent)GetProcAddress(
            GetModuleHandleA("ntdll.dll"), "NtReleaseKeyedEvent");
    }
    // NULL handle ⇒ kernel substitutes peb->KeyedEventHandle.
    // If no waiter exists yet, this call blocks until one shows up — that
    // symmetry is what keeps the global event correct under contention.
    g_release(NULL, (PVOID)lockSlot, FALSE, NULL);
}

rustwindows-sys: WakeByAddressSingle (recommended modern wake)

// On Win8+ this is the preferred user-mode wake primitive; underneath it
// resolves to keyed-event releases for the futex-style address path.
use windows_sys::Win32::System::Threading::WakeByAddressSingle;

unsafe fn wake_one(addr: *mut u32) {
    WakeByAddressSingle(addr as *const _ as _);
}

Mapeos MITRE ATT&CK

Last verified: 2026-05-20