IPortClsVersion ::GetVersion, méthode (portcls.h)
La méthode GetVersion retourne la version du système d’exploitation Windows sur laquelle le pilote s’exécute.
Syntaxe
DWORD GetVersion();
Valeur de retour
La méthode GetVersion retourne une valeur DWORD qui spécifie le numéro de version Windows. Pour plus d’informations, consultez la section Remarques suivante.
Remarques
La méthode GetVersion retourne les informations de version qui spécifient la version de Windows.
Les numéros de version Windows possibles que GetVersion peuvent retourner sont indiqués dans le tableau suivant.
| Numéro de version | Windows Version | Soutient |
|---|---|---|
| kVersionWin98 | Windows 98 | Non |
| kVersionWin98SE | Windows 98 Seconde Édition | Non |
| kVersionWin2K | Windows 2000 | Non |
| kVersionWin98SE_QFE2 | Windows 98 SE + Hot-Fix package 269601.) | Non |
| kVersionWin2K_SP2 | Windows 2000 + Service Pack 2 | OUI |
| kVersionWinME | Windows Me | Non |
| kVersionWin98SE_QFE3 | Réservé à une utilisation ultérieure | OUI |
| kVersionWinME_QFE1 | Réservé à une utilisation ultérieure | OUI |
| kVersionWinXP | Windows XP | OUI |
| kVersionWinXPSP1 | Windows XP + Service Pack 1 | OUI |
| kVersionWinServer2003 | Windows Server 2003 | OUI |
| kVersionWin2K_UAAQFE | Package windows 2000 + correctif à chaud avec prise en charge de IUnregister_Xxx_ (voir Sous-éléments audio dynamiques.) | OUI |
| kVersionWinXP_UAAQFE | Package windows XP + correctif rapide avec prise en charge de IUnregister_Xxx_ (voir Sous-éléments audio dynamiques.) | OUI |
| kVersionWinServer2003_UAAQFE | Package windows Server 2003 + correctif à chaud avec prise en charge de IUnregister_Xxx_ (voir Sous-éléments audio dynamiques.) | OUI |
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 pour les versions de Windows qui ne prennent pas en charge l’interface IPortClsVersion. Les deux types de numéros 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 l’un des numéros 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 reposent généralement sur la fonction IoIsWdmVersionAvailable. Pour obtenir un exemple de code de cette 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 l’ordre chronologique à peu près. Chaque version successive de Windows dans le tableau ne représente pas nécessairement un super-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.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Universel |
| d’en-tête | portcls.h (include Portcls.h) |
| IRQL | PASSIVE_LEVEL |