Partager via


Fonction RtlGetVersion (wdm.h)

La routine RtlGetVersion retourne des informations de version sur le système d’exploitation en cours d’exécution.

Syntaxe

NTSYSAPI NTSTATUS RtlGetVersion(
  [out] PRTL_OSVERSIONINFOW lpVersionInformation
);

Paramètres

[out] lpVersionInformation

Pointeur vers une structure RTL_OSVERSIONINFOW ou une structure de RTL_OSVERSIONINFOEXW qui contient les informations de version sur le système d’exploitation en cours d’exécution. Un appelant spécifie la structure d’entrée utilisée en définissant le membre dwOSVersionInfoSize de la structure sur la taille en octets de la structure utilisée.

Valeur retournée

RtlGetVersion retourne STATUS_SUCCESS.

Remarques

RtlGetVersion est l’équivalent en mode noyau de la fonction GetVersionEx en mode utilisateur dans le Kit de développement logiciel (SDK) Windows. Consultez l’exemple dans le Kit de développement logiciel (SDK) Windows qui montre comment obtenir la version du système.

Lorsque vous utilisez RtlGetVersion pour déterminer si une version particulière du système d’exploitation est en cours d’exécution, un appelant doit case activée pour les numéros de version supérieurs ou égaux au numéro de version requis. Cela garantit qu’un test de version réussit pour les versions ultérieures de Windows.

Étant donné que les fonctionnalités du système d’exploitation peuvent être ajoutées dans une DLL redistribuable, la vérification uniquement des numéros de version principale et secondaire n’est pas le moyen le plus fiable de vérifier la présence d’une fonctionnalité système spécifique. Un pilote doit utiliser RtlVerifyVersionInfo pour tester la présence d’une fonctionnalité système spécifique.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Disponible à partir de Windows 2000.
Plateforme cible Universal
En-tête wdm.h (include Ntddk.h)
Bibliothèque NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL

Voir aussi

PsGetVersion