IPortClsVersion::GetVersion メソッド (portcls.h)
メソッドは GetVersion
、ドライバーが実行されている Windows オペレーティング システムのバージョンを返します。
構文
DWORD GetVersion();
戻り値
メソッドは GetVersion
、Windows バージョン番号を指定する DWORD 値を返します。 詳細については、「解説」を参照してください。
注釈
メソッドは GetVersion
、Windows リリースを指定するバージョン情報を返します。
返すことができる Windows バージョン番号を GetVersion
次の表に示します。
バージョン番号 | Windows のバージョン | サポート |
---|---|---|
kVersionWin98 | Windows 98 | no |
kVersionWin98SE | Windows 98 Second Edition | no |
kVersionWin2K | Windows 2000 | no |
kVersionWin98SE_QFE2 | Windows 98 SE + Hot-Fix パッケージ 269601)。) | no |
kVersionWin2K_SP2 | Windows 2000 + Service Pack 2 | YES |
kVersionWinME | Windows Me | no |
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 + IUnregister_Xxx_ サポート付きのホットフィックス パッケージ ( 「Dynamic Audio Subdevices」を参照)。 | YES |
kVersionWinXP_UAAQFE | IUnregister_Xxx_サポートを備えた Windows XP + ホットフィックス パッケージ ( 「ダイナミック オーディオ サブデバイス」を参照)。 | YES |
kVersionWinServer2003_UAAQFE | Windows Server 2003 + IUnregister_Xxx_ サポート付きのホットフィックス パッケージ ( 「ダイナミック オーディオ サブデバイス」を参照)。 | YES |
前の表のバージョン番号は、ヘッダー ファイル portcls.h で定義されています。 portcls.h は、 IPortClsVersion インターフェイスをサポートする Windows バージョンとサポートしていないバージョンの両方に対してバージョン番号を定義します。 どちらの種類のバージョン番号も役立ちます。 ミニポート ドライバーには、通常、Windows のバージョンを決定し、前の表のいずれかのバージョン番号を返すことができる独自のルーチンが含まれています。 IPortClsVersion をサポートしていないプラットフォームで実行する場合、このルーチンは他のソフトウェア テストを使用して Windows のバージョンを決定する必要があります。 通常、これらのテストは IoIsWdmVersionAvailable 関数に依存します。 このようなルーチンのコード例については、Windows Driver Kit (WDK) の sb16 サンプル オーディオ ドライバーに関するページを参照してください。
前の表のバージョン番号は、ほぼ時系列で一覧表示されています。 テーブル内の連続する各 Windows バージョンは、前のバージョンの機能スーパーセットを必ずしも表すわけではありません。 たとえば、 kVersionWin2K で表されるバージョンには、 kVersionWin98SE_QFE2で表されるバージョンよりも多くのオーディオ機能があります。
要件
要件 | 値 |
---|---|
対象プラットフォーム | ユニバーサル |
Header | portcls.h (Portcls.h を含む) |
IRQL | PASSIVE_LEVEL |