> Windows Syscalls
ntoskrnl.exeT1542.001T1106

NtQuerySystemEnvironmentValue

Lit une variable d'environnement système BIOS/NV-RAM x86 héritée par nom (interface pré-UEFI).

Prototype

NTSTATUS NtQuerySystemEnvironmentValue(
  PUNICODE_STRING VariableName,
  PWCHAR          VariableValue,
  USHORT          ValueLength,
  PUSHORT         ReturnLength
);

Arguments

NameTypeDirDescription
VariableNamePUNICODE_STRINGinUNICODE_STRING désignant la variable. Correspond aux noms BIOS NV-RAM hérités ; pas d'espace GUID.
VariableValuePWCHARoutTampon alloué par l'appelant recevant la valeur de la variable en chaîne de caractères larges.
ValueLengthUSHORTinCapacité de VariableValue en octets (taille USHORT : maximum 64 Kio).
ReturnLengthPUSHORToutPointeur optionnel recevant le nombre d'octets effectivement écrits.

IDs de syscalls par version de Windows

Version de WindowsID de syscallBuild
Win10 15070x145win10-1507
Win10 16070x14Cwin10-1607
Win10 17030x152win10-1703
Win10 17090x155win10-1709
Win10 18030x157win10-1803
Win10 18090x158win10-1809
Win10 19030x159win10-1903
Win10 19090x159win10-1909
Win10 20040x15Fwin10-2004
Win10 20H20x15Fwin10-20h2
Win10 21H10x15Fwin10-21h1
Win10 21H20x160win10-21h2
Win10 22H20x160win10-22h2
Win11 21H20x167win11-21h2
Win11 22H20x16Awin11-22h2
Win11 23H20x16Awin11-23h2
Win11 24H20x16Cwin11-24h2
Server 20160x14Cwinserver-2016
Server 20190x158winserver-2019
Server 20220x165winserver-2022
Server 20250x16Cwinserver-2025

Module noyau

ntoskrnl.exeNtQuerySystemEnvironmentValue

APIs liées

GetFirmwareEnvironmentVariableWNtQuerySystemEnvironmentValueExNtSetSystemEnvironmentValueRtlAdjustPrivilege

Stub du syscall

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

Interface héritée de l'ère NT/x86 BIOS originale pour lire des valeurs d'environnement système non volatiles. Le nom est résolu via des stockages NV-RAM privés au HAL ; sur les machines UEFI modernes l'appel est essentiellement vestigial — les chemins noyau redirigent les lectures de firmware réelles vers NtQuerySystemEnvironmentValueEx. Nécessite SeSystemEnvironmentPrivilege. La limite de longueur USHORT 16 bits est un artefact historique manifeste et l'une des raisons pour lesquelles le code neuf doit utiliser la variante Ex.

Usage courant par les malwares

Très faible signal offensif en 2025. La plupart du tradecraft moderne ciblant le firmware (LoJax, MosaicRegressor, ESPecter) vise la surface des variables UEFI via les contreparties *Ex*, car c'est là que résident réellement les clés Secure Boot, le BootOrder et l'état de passation au chargeur d'OS. Apparitions occasionnelles dans d'anciens toolkits red-team auditant l'état du BIOS sur machines héritées.

Opportunités de détection

Le fournisseur ETW Microsoft-Windows-Kernel-General émet des événements d'accès firmware ; à corréler avec l'octroi de SeSystemEnvironmentPrivilege sur le token appelant. Les appels depuis des binaires non liés à la gestion firmware (hors bcdedit.exe, mountvol.exe, utilitaires fwupdate, outils de gestion constructeurs) sont intrinsèquement suspects. Les EDR ne hookent presque jamais cet appel directement car le volume légitime est proche de zéro — tout appel devient donc un signal à haute fidélité.

Exemples de syscalls directs

asmx64 direct stub (Win11 24H2)

; Direct syscall stub for NtQuerySystemEnvironmentValue (SSN 0x16C, Win11 24H2)
NtQuerySystemEnvironmentValue PROC
    mov  r10, rcx
    mov  eax, 16Ch
    syscall
    ret
NtQuerySystemEnvironmentValue ENDP

cLegacy NV-RAM read via Win32 wrapper

// Win32 calls back into NtQuerySystemEnvironmentValue under the hood.
// Requires SeSystemEnvironmentPrivilege — enable it first or the call returns ERROR_PRIVILEGE_NOT_HELD.
WCHAR buf[256] = {0};
DWORD len = GetFirmwareEnvironmentVariableW(
    L"BootOrder",
    L"{00000000-0000-0000-0000-000000000000}", // legacy non-UEFI: ignored
    buf,
    sizeof(buf));
if (len == 0) {
    // On modern UEFI systems GetFirmwareEnvironmentVariableW dispatches to the Ex variant.
    // Failure here on a UEFI machine is expected for legacy names.
}

Mappings MITRE ATT&CK

Last verified: 2026-05-20