IPortClsVersion::GetVersion 方法 (portcls.h)
方法 GetVersion
會傳回驅動程序執行所在的 Windows 作業系統版本。
Syntax
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 | Windows 2000 + hot-fix 套件與IUnregister_Xxx_支援 (請參閱 動態音訊 Subdevices.) | YES |
kVersionWinXP_UAAQFE | Windows XP + hot-fix 套件與IUnregister_Xxx_支援 (請參閱 動態音訊 Subdevices.) | YES |
kVersionWinServer2003_UAAQFE | Windows Server 2003 + hot-fix 套件與IUnregister_Xxx_支援 (請參閱 動態音訊 Subdevices.) | YES |
上表中的版本號碼定義於頭檔 portcls.h 中。 請注意,portcls.h 會針對不支援 IPortClsVersion 介面的 Windows 版本定義版本號碼。 這兩種類型的版本號碼都很有用。 迷你埠驅動程式通常包含專屬例程,可決定 Windows 版本,並可傳回上表中的任何版本號碼。 在不支援 IPortClsVersion 的平台上執行時,此例程需要使用其他軟體測試來判斷 Windows 版本。 這些測試通常依賴 IoIsWdmVersionAvailable函式 。 如需這類例程的程式代碼範例,請參閱 Windows 驅動程式套件中的 sb16 範例音訊驅動程式 (WDK) 。
上表中的版本號碼會依大致時間順序列出。 數據表中的每個後續 Windows 版本不一定代表先前版本的功能超集。 例如, kVersionWin2K 所代表的版本具有比 kVersionWin98SE_QFE2所代表的版本更多的音訊功能。
規格需求
需求 | 值 |
---|---|
目標平台 | Universal |
標頭 | portcls.h (包含 Portcls.h) |
IRQL | PASSIVE_LEVEL |