IPortClsVersion::GetVersion-Methode (portcls.h)
Die GetVersion -Methode gibt die Version des Windows-Betriebssystems zurück, unter dem der Treiber ausgeführt wird.
Syntax
DWORD GetVersion();
Rückgabewert
Die GetVersion -Methode gibt einen DWORD-Wert zurück, der die Windows-Versionsnummer angibt. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".
Hinweise
Die GetVersion -Methode gibt Versionsinformationen zurück, die die Windows-Version angibt.
Die möglichen Windows-Versionsnummern, die zurückgegeben werden können, GetVersion sind in der folgenden Tabelle aufgeführt.
| Versionsnummer | Windows-Version | Unterstützt |
|---|---|---|
| kVersionWin98 | Windows 98 | nein |
| kVersionWin98SE | Windows 98 Second Edition | nein |
| kVersionWin2K | Windows 2000 | nein |
| kVersionWin98SE_QFE2 | Windows 98 SE + Hot-Fix-Paket 269601.) | nein |
| kVersionWin2K_SP2 | Windows 2000 + Service Pack 2 | YES |
| kVersionWinME | Windows Me | nein |
| kVersionWin98SE_QFE3 | Für die zukünftige Verwendung reserviert | YES |
| kVersionWinME_QFE1 | Für die zukünftige Verwendung reserviert | YES |
| kVersionWinXP | Windows XP | YES |
| kVersionWinXPSP1 | Windows XP + Service Pack 1 | YES |
| kVersionWinServer2003 | Windows Server 2003 | YES |
| kVersionWin2K_UAAQFE | Windows 2000 + Hot-Fix-Paket mit IUnregister_Xxx_ Unterstützung (siehe Dynamische Audiountergeräte.) | YES |
| kVersionWinXP_UAAQFE | Windows XP + Hot-Fix-Paket mit IUnregister_Xxx_-Unterstützung (siehe Dynamische Audiountergeräte.) | YES |
| kVersionWinServer2003_UAAQFE | Windows Server 2003 + Hot-Fix-Paket mit IUnregister_Xxx_-Unterstützung (siehe Dynamische Audiountergeräte).) | YES |
Die Versionsnummern in der vorherigen Tabelle sind in der Headerdatei portcls.h definiert. Beachten Sie, dass portcls.h Versionsnummern sowohl für Windows-Versionen definiert, die die IPortClsVersion-Schnittstelle unterstützen als auch nicht. Beide Typen von Versionsnummer können nützlich sein. Ein Miniporttreiber enthält in der Regel eine proprietäre Routine, die die Windows-Version bestimmt und eine der Versionsnummern in der vorherigen Tabelle zurückgeben kann. Wenn diese Routine auf einer Plattform ausgeführt wird, die IPortClsVersion nicht unterstützt, muss diese Routine andere Softwaretests verwenden, um die Windows-Version zu bestimmen. Diese Tests basieren in der Regel auf der IoIsWdmVersionAvailable-Funktion . Ein Codebeispiel für eine solche Routine finden Sie im Sb16-Beispiel-Audiotreiber im Windows Driver Kit (WDK).
Die Versionsnummern in der vorherigen Tabelle sind ungefähr chronologisch aufgeführt. Jede nachfolgende Windows-Version in der Tabelle stellt nicht notwendigerweise eine Feature-Obermenge der vorherigen Version dar. Die Version, die von kVersionWin2K dargestellt wird, verfügt beispielsweise über mehr Audiofeatures als die Version, die durch kVersionWin98SE_QFE2 dargestellt wird.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Universell |
| Header | portcls.h (include Portcls.h) |
| IRQL | PASSIVE_LEVEL |