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
| Name | Type | Dir | Description |
|---|---|---|---|
| Ids | PULONG | in | Tableau d'identifiants BOOT_ENTRY dans l'ordre de tentative souhaité. L'index 0 est essayé en premier. |
| Count | ULONG | in | Nombre 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 Windows | ID de syscall | Build |
|---|---|---|
| Win10 1507 | 0x16C | win10-1507 |
| Win10 1607 | 0x174 | win10-1607 |
| Win10 1703 | 0x17A | win10-1703 |
| Win10 1709 | 0x17D | win10-1709 |
| Win10 1803 | 0x17F | win10-1803 |
| Win10 1809 | 0x180 | win10-1809 |
| Win10 1903 | 0x181 | win10-1903 |
| Win10 1909 | 0x181 | win10-1909 |
| Win10 2004 | 0x187 | win10-2004 |
| Win10 20H2 | 0x187 | win10-20h2 |
| Win10 21H1 | 0x187 | win10-21h1 |
| Win10 21H2 | 0x189 | win10-21h2 |
| Win10 22H2 | 0x189 | win10-22h2 |
| Win11 21H2 | 0x191 | win11-21h2 |
| Win11 22H2 | 0x194 | win11-22h2 |
| Win11 23H2 | 0x194 | win11-23h2 |
| Win11 24H2 | 0x196 | win11-24h2 |
| Server 2016 | 0x174 | winserver-2016 |
| Server 2019 | 0x180 | winserver-2019 |
| Server 2022 | 0x18F | winserver-2022 |
| Server 2025 | 0x196 | winserver-2025 |
Module noyau
APIs liées
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 ENDPcPromote 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