IPortClsVersion::GetVersion method (portcls.h)
The GetVersion method returns the version of the Windows operating system that the driver is running on.
Syntax
DWORD GetVersion();
Return value
The GetVersion method returns a DWORD value that specifies the Windows version number. For more information, see the following Remarks section.
Remarks
The GetVersion method returns version information that specifies the Windows release.
The possible Windows version numbers that GetVersion can return are shown in the following table.
| Version Number | Windows Version | Supports |
|---|---|---|
| kVersionWin98 | Windows 98 | no |
| kVersionWin98SE | Windows 98 Second Edition | no |
| kVersionWin2K | Windows 2000 | no |
| kVersionWin98SE_QFE2 | Windows 98 SE + Hot-Fix Package 269601.) | no |
| kVersionWin2K_SP2 | Windows 2000 + Service Pack 2 | YES |
| kVersionWinME | Windows Me | no |
| kVersionWin98SE_QFE3 | Reserved for future use | YES |
| kVersionWinME_QFE1 | Reserved for future use | YES |
| kVersionWinXP | Windows XP | YES |
| kVersionWinXPSP1 | Windows XP + Service Pack 1 | YES |
| kVersionWinServer2003 | Windows Server 2003 | YES |
| kVersionWin2K_UAAQFE | Windows 2000 + hot-fix package with IUnregister_Xxx_ support (See Dynamic Audio Subdevices.) | YES |
| kVersionWinXP_UAAQFE | Windows XP + hot-fix package with IUnregister_Xxx_ support (See Dynamic Audio Subdevices.) | YES |
| kVersionWinServer2003_UAAQFE | Windows Server 2003 + hot-fix package with IUnregister_Xxx_ support (See Dynamic Audio Subdevices.) | YES |
The version numbers in the preceding table are defined in header file portcls.h. Note that portcls.h defines version numbers both for Windows versions that do and do not support the IPortClsVersion interface. Both types of version number can be useful. A miniport driver typically contains a proprietary routine that determines the Windows version and can return any of the version numbers in the preceding table. When executed on a platform that does not support IPortClsVersion, this routine needs to use other software tests to determine the Windows version. These tests typically rely on the IoIsWdmVersionAvailable function. For a code example of such a routine, see the sb16 sample audio driver in the Windows Driver Kit (WDK).
The version numbers in the preceding table are listed in roughly chronological order. Each successive Windows version in the table does not necessarily represent a feature superset of the preceding version. For example, the version that is represented by kVersionWin2K has more audio features than the version that is represented by kVersionWin98SE_QFE2.
Requirements
| Requirement | Value |
|---|---|
| Target Platform | Universal |
| Header | portcls.h (include Portcls.h) |
| IRQL | PASSIVE_LEVEL |