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 |