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 |