IPortClsVersion::GetVersion 方法 (portcls.h)

方法 GetVersion 返回运行驱动程序的 Windows 操作系统的版本。

语法

DWORD GetVersion();

返回值

方法 GetVersion 返回指定 Windows 版本号的 DWORD 值。 有关更多信息,请参见下面的“备注”部分。

注解

方法 GetVersion 返回指定 Windows 版本的版本信息。

下表显示了可能返回的 Windows 版本号 GetVersion

版本号 Windows 版本 支持
kVersionWin98 Windows 98
kVersionWin98SE Windows 98 Second Edition
kVersionWin2K Windows 2000
kVersionWin98SE_QFE2 Windows 98 SE + Hot-Fix 程序包269601.)
kVersionWin2K_SP2 Windows 2000 + Service Pack 2 YES
kVersionWinME Windows Me
kVersionWin98SE_QFE3 保留以供将来使用 YES
kVersionWinME_QFE1 保留以供将来使用 YES
kVersionWinXP Windows XP YES
kVersionWinXPSP1 Windows XP + Service Pack 1 YES
kVersionWinServer2003 Windows Server 2003 YES
kVersionWin2K_UAAQFE 支持IUnregister_Xxx_的 Windows 2000 + 热修复程序包 (请参阅 动态音频 Subdevices.) YES
kVersionWinXP_UAAQFE 具有IUnregister_Xxx_支持的 Windows XP + 热修复包 (请参阅 动态音频子设备.) YES
kVersionWinServer2003_UAAQFE 具有IUnregister_Xxx_支持的 Windows Server 2003 + 热修补程序包 (请参阅 动态音频 Subdevices.) YES

上表中的版本号在头文件 portcls.h 中定义。 请注意,portcls.h 为支持和不支持 IPortClsVersion 接口的 Windows 版本定义版本号。 这两种类型的版本号都很有用。 微型端口驱动程序通常包含一个专有例程,该例程确定 Windows 版本,并且可以返回上表中的任何版本号。 在不支持 IPortClsVersion 的平台上执行时,此例程需要使用其他软件测试来确定 Windows 版本。 这些测试通常依赖于 IoIsWdmVersionAvailable 函数。 有关此类例程的代码示例,请参阅 Windows 驱动程序工具包 (WDK) 中的 sb16 示例音频驱动程序。

上表中的版本号按大致时间顺序列出。 表中每个连续的 Windows 版本不一定表示前面版本的功能超集。 例如, kVersionWin2K 表示的版本具有比 kVersionWin98SE_QFE2 表示的版本更多的音频功能。

要求

要求
目标平台 通用
标头 portcls.h (包括 Portcls.h)
IRQL PASSIVE_LEVEL

另请参阅

IPortClsVersion

IoIsWdmVersionAvailable