Méthode IPortClsVersion ::GetVersion (portcls.h)

La GetVersion méthode retourne la version du système d’exploitation Windows sur lequel le pilote s’exécute.

Syntaxe

DWORD GetVersion();

Valeur de retour

La GetVersion méthode retourne une valeur DWORD qui spécifie le numéro de version Windows. Pour plus d'informations, consultez la section Notes qui suit.

Remarques

La GetVersion méthode retourne des informations de version qui spécifient la version de Windows.

Les numéros de version Windows possibles qui GetVersion peuvent être retournés sont indiqués dans le tableau suivant.

Numéro de version	Version de Windows	Prise en charge
kVersionWin98	Windows 98	non
kVersionWin98SE	Windows 98 Deuxième Édition	non
kVersionWin2K	Windows 2000	non
kVersionWin98SE_QFE2	Windows 98 SE + Hot-Fix Package 269601.)	non
kVersionWin2K_SP2	Windows 2000 + Service Pack 2	YES
kVersionWinME	Windows Me	non
kVersionWin98SE_QFE3	Paramètres réservés pour un usage ultérieur	YES
kVersionWinME_QFE1	Paramètres réservés pour un usage ultérieur	YES
kVersionWinXP	Windows XP	YES
kVersionWinXPSP1	Windows XP + Service Pack 1	YES
kVersionWinServer2003	Windows Server 2003	YES
kVersionWin2K_UAAQFE	Package windows 2000 + correctif à chaud avec prise en charge IUnregister_Xxx_ (voir Sous-appareils audio dynamiques.)	YES
kVersionWinXP_UAAQFE	Package Windows XP + correctif à chaud avec prise en charge IUnregister_Xxx_ (voir Sous-appareils audio dynamiques).)	YES
kVersionWinServer2003_UAAQFE	Package Windows Server 2003 + correctif à chaud avec prise en charge de IUnregister_Xxx_ (voir Sous-appareils audio dynamiques).)	YES

Les numéros de version du tableau précédent sont définis dans le fichier d’en-tête portcls.h. Notez que portcls.h définit les numéros de version à la fois pour les versions Windows qui ne prennent pas en charge l’interface IPortClsVersion . Les deux types de numéro de version peuvent être utiles. Un pilote miniport contient généralement une routine propriétaire qui détermine la version de Windows et peut retourner n’importe quel numéro de version dans le tableau précédent. Lorsqu’elle est exécutée sur une plateforme qui ne prend pas en charge IPortClsVersion, cette routine doit utiliser d’autres tests logiciels pour déterminer la version de Windows. Ces tests s’appuient généralement sur la fonction IoIsWdmVersionAvailable . Pour obtenir un exemple de code d’une telle routine, consultez l’exemple de pilote audio sb16 dans le Kit de pilotes Windows (WDK).

Les numéros de version du tableau précédent sont répertoriés dans un ordre approximativement chronologique. Chaque version de Windows successive dans la table ne représente pas nécessairement un sur-ensemble de fonctionnalités de la version précédente. Par exemple, la version représentée par kVersionWin2K a plus de fonctionnalités audio que la version représentée par kVersionWin98SE_QFE2.

Configuration requise

Condition requise	Valeur
Plateforme cible	Universal
En-tête	portcls.h (include Portcls.h)
IRQL	PASSIVE_LEVEL

Voir aussi

IPortClsVersion

IoIsWdmVersionAvailable