IPortClsVersion::GetVersion-Methode (portcls.h)

  • Artikel

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

Weitere Informationen

IPortClsVersion

IoIsWdmVersionAvailable