次の方法で共有

IoIsWdmVersionAvailable 関数 (wdm.h)

  • [アーティクル]

IoIsWdmVersionAvailable ルーチンは、特定の WDM バージョンがオペレーティング システムでサポートされているかどうかを確認します。

構文

BOOLEAN IoIsWdmVersionAvailable(
  [in] UCHAR MajorVersion,
  [in] UCHAR MinorVersion
);

パラメーター

[in] MajorVersion

要求される WDM のメジャー バージョン番号を指定します。

[in] MinorVersion

要求される WDM のマイナー バージョン番号を指定します。

戻り値

IoIsWdmVersionAvailable は、オペレーティング システムが提供する WDM のバージョンが、要求されている WDM のバージョン番号以上の場合、TRUE を返します。 それ以外の場合は、FALSE 返します。

備考

ドライバーは、IoIsWdmVersionAvailable ルーチンの代わりに、RtlIsNtDdiVersionAvailable ルーチンを使用する必要があります。

クロスプラットフォーム ドライバーは、プラットフォームによって異なる、または WDM のすべてのバージョンでサポートされていない操作を実行する前に、WDM のバージョンを確認するには、このルーチンを使用する必要があります。

Wdm.h ヘッダー ファイルで定義されているWDM_MAJORVERSION定数とWDM_MINORVERSION定数は、現在のバージョンの Windows の WDM メジャー バージョン番号とマイナー バージョン番号を指定します。 各オペレーティング システムで提供される WDM バージョンを次に示します。

オペレーティング システム WDM メジャー バージョン WDM マイナー バージョン
Windows 7 6 0x00
Windows Server 2008 R2 6 0x00
Windows Server 2008 6 0x00
Windows Vista 6 0x00
Windows Server 2003 1 0x30
Windows XP 1 0x20
Windows 2000 1 0x10
Windows Me 1 0x05
Windows 98 1 0x00

マイナー バージョン番号は 16 進値として定義されていることに注意してください。

それ以降のバージョンの WDM では、以前のバージョンの WDM で使用できるすべての機能がサポートされています。つまり、WDM の各バージョンは、以前の WDM バージョンのスーパーセットです。

次の呼び出しは、すべてのシステムが WDM 1.0 のすべての機能をサポートしているため、一覧表示されているオペレーティング システムで TRUE 返します。

bVersion = IoIsWdmVersionAvailable(1,0);

次の例は、ドライバーが現在のオペレーティング システムを動的に検出する方法を示しています。

if (IoIsWdmVersionAvailable(1, 0x10)) {
    //
    //If WDM 1.10 is supported, this is Windows 2000
    //or better.
    //
} else if (IoIsWdmVersionAvailable(1, 5)) {
    //
    //If WDM 1.05 is supported, this is Windows ME
    //or better.
    //
} else {
    //
    //WDM 1.0 is always supported, so this is Windows 98, 
    //Windows 98 SE, or better.
    //
}

この例に示すように、IoIsWdmVersionAvailable(1, 5) を呼び出すと、Windows Me、Windows 2000、および成功するオペレーティング システムでは TRUE が 返されますが、Windows 98 および Windows 98 SE では FALSE 。

必要条件

要件 価値
ターゲット プラットフォーム の 万国
ヘッダー wdm.h (Wdm.h、Ntddk.h、Ntifs.h を含む)
ライブラリ NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL
DDI コンプライアンス規則 を する HwStorPortProhibitedDDDIs(storport), IrqlIoPassive5(wdm), PowerIrpDDis(wdm)

関連項目

RtlIsNtDdiVersionAvailable を する