> Windows Syscalls
ntoskrnl.exeT1542.003T1542T1106

NtSetBootEntryOrder

Écrit l'ordre des tentatives de démarrage firmware — le tableau d'IDs BOOT_ENTRY que la plateforme tentera en séquence.

Prototype

NTSTATUS NtSetBootEntryOrder(
  PULONG Ids,
  ULONG  Count
);

Arguments

NameTypeDirDescription
IdsPULONGinTableau d'identifiants BOOT_ENTRY dans l'ordre de tentative souhaité. L'index 0 est essayé en premier.
CountULONGinNombre d'entrées dans Ids. Doit correspondre à chaque ID actuellement enregistré — les ordres partiels sont rejetés.

IDs de syscalls par version de Windows

Version de WindowsID de syscallBuild
Win10 15070x16Cwin10-1507
Win10 16070x174win10-1607
Win10 17030x17Awin10-1703
Win10 17090x17Dwin10-1709
Win10 18030x17Fwin10-1803
Win10 18090x180win10-1809
Win10 19030x181win10-1903
Win10 19090x181win10-1909
Win10 20040x187win10-2004
Win10 20H20x187win10-20h2
Win10 21H10x187win10-21h1
Win10 21H20x189win10-21h2
Win10 22H20x189win10-22h2
Win11 21H20x191win11-21h2
Win11 22H20x194win11-22h2
Win11 23H20x194win11-23h2
Win11 24H20x196win11-24h2
Server 20160x174winserver-2016
Server 20190x180winserver-2019
Server 20220x18Fwinserver-2022
Server 20250x196winserver-2025

Module noyau

ntoskrnl.exeNtSetBootEntryOrder

APIs liées

SetFirmwareEnvironmentVariableW (BootOrder)bcdedit.exe /defaultbcdedit.exe /bootsequenceBcdSetElementData (Boot Order GUID)NtQueryBootEntryOrderNtAddBootEntry

Stub du syscall

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

Le pendant en écriture de NtQueryBootEntryOrder. Sur UEFI, le noyau appelle in fine `EFI_SET_VARIABLE` sur la variable globale `BootOrder` (GUID fournisseur `{8BE4DF61-93CA-11d2-AA0D-00E098032B8C}`) avec `EFI_VARIABLE_NON_VOLATILE | EFI_VARIABLE_BOOTSERVICE_ACCESS | EFI_VARIABLE_RUNTIME_ACCESS`. SeSystemEnvironmentPrivilege est obligatoire et l'appel échoue STATUS_INVALID_PARAMETER si un ID fourni n'existe pas.

Usage courant par les malwares

Le couronnement de l'installation de bootkit BCD : une fois un `Boot####` corrompu enregistré via NtAddBootEntry, c'est cet appel qui **gagne** le prochain redémarrage pour l'attaquant en promouvant cet ID en position 0. Sans cette étape, l'entrée de l'attaquant est dormante — UEFI essaie d'abord le Windows Boot Manager existant et ne l'atteint jamais. La réorganisation est ce qui rend l'implant actif. BlackLotus, ESPecter et le module TrickBoot terminent chacun leur chemin d'installation par cette primitive.

Opportunités de détection

**Signal BCD à la plus haute fidélité de la famille.** Toute modification de `BootOrder` qui promeut une entrée non Microsoft, non OEM-recovery, au slot 0 est essentiellement diagnostique d'une tentative de bootkit. Surveiller : événements de changement d'ordre ETW Microsoft-Windows-Kernel-Boot, événements registre Sysmon sur les écritures BCD, et la variable EFI `BootOrder` via un scan CHIPSEC ou Eclypsium périodique. Les défenseurs doivent aussi inscrire les endpoints en **Measured Boot + attestation distante** — les mesures PCR[4] (hash de l'image du boot manager) et PCR[7] (politique Secure Boot + hash de la DB signatures) divergent de la baseline attendue dès le tout premier démarrage compromis, avant même que l'utilisateur soit connecté.

Exemples de syscalls directs

asmx64 direct stub (Win11 24H2, SSN 0x196)

NtSetBootEntryOrder PROC
    mov  r10, rcx          ; PULONG Ids
    mov  eax, 0196h        ; Win11 24H2
    syscall
    ret
NtSetBootEntryOrder ENDP

cPromote attacker ID to slot 0 (PoC)

// PoC: read order, move our_id to the front, write back.
extern NTSTATUS NTAPI NtQueryBootEntryOrder(PULONG, PULONG);
extern NTSTATUS NTAPI NtSetBootEntryOrder(PULONG, ULONG);

NTSTATUS promote(ULONG our_id) {
    ULONG count = 0;
    NtQueryBootEntryOrder(NULL, &count);
    PULONG ids = (PULONG)HeapAlloc(GetProcessHeap(), 0, count * sizeof(ULONG));
    NtQueryBootEntryOrder(ids, &count);
    // find our_id, swap to front
    for (ULONG i = 0; i < count; ++i) {
        if (ids[i] == our_id) {
            memmove(&ids[1], &ids[0], i * sizeof(ULONG));
            ids[0] = our_id;
            break;
        }
    }
    NTSTATUS s = NtSetBootEntryOrder(ids, count);
    HeapFree(GetProcessHeap(), 0, ids);
    return s;
}

rustNaked stub

use std::arch::asm;

#[unsafe(naked)]
unsafe extern "system" fn nt_set_boot_entry_order(_ids: *const u32, _count: u32) -> i32 {
    asm!(
        "mov r10, rcx",
        "mov eax, 0x196",  // Win11 24H2
        "syscall",
        "ret",
        options(noreturn),
    );
}

Mappings MITRE ATT&CK

Last verified: 2026-05-20