RtlVerifyVersionInfo 関数 (wdm.h)

[アーティクル]
03/08/2023

RtlVerifyVersionInfo ルーチンは、オペレーティングシステムのバージョン要件の指定されたセットを、現在実行中のオペレーティングシステムの対応する属性と比較します。

構文

NTSYSAPI NTSTATUS RtlVerifyVersionInfo(
  [in] PRTL_OSVERSIONINFOEXW VersionInfo,
  [in] ULONG                 TypeMask,
  [in] ULONGLONG             ConditionMask
);

パラメーター

[in] VersionInfo

オペレーティング システムの現在 実行中のバージョンの対応する属性と比較するオペレーティングシステムのバージョン要件を指定するRTL_OSVERSIONINFOEXW構造体へのポインター。

[in] TypeMask

オペレーティングシステムの現在実行中のバージョンの対応する属性と比較する VersionInfo のメンバーを指定します。 TypeMask は、次の 1 つ以上の値の論理 OR に設定されます。

値	対応するメンバー
VER_BUILDNUMBER	dwBuildNumber
VER_MAJORVERSION	dwMajorVersion
VER_MINORVERSION	dwMinorVersion
VER_PLATFORMID	dwPlatformId
VER_SERVICEPACKMAJOR	wServicePackMajor
VER_SERVICEPACKMINOR	wServicePackMinor
VER_SUITENAME	wSuiteMask
VER_PRODUCT_TYPE	wProductType

[in] ConditionMask

各 VersionInfo メンバーを比較する方法を指定します。 ConditionMask の値を設定するには、呼び出し元で VER_SET_CONDITION マクロを使用する必要があります。

VER_SET_CONDITION (
        IN OUT  ULONGLONG  ConditionMask,
        IN ULONG  TypeBitMask,
        IN UCHAR  ComparisonType
        );

ConditionMask の値は、次の方法で作成されます。

ConditionMask の値を 0 に初期化します。
TypeMask で指定された VersionInfo メンバーごとに、VER_SET_CONDITIONを 1 回呼び出します。
各呼び出しの TypeBitMask パラメーターと ComparisonType パラメーターを次のように VER_SET_CONDITION に設定します。

TypeBitMask

比較の種類が設定されている VersionInfo メンバーを示します。 TypeBitMask には、次のいずれかの値を指定できます。

値	対応するメンバー
VER_BUILDNUMBER	dwBuildNumber
VER_MAJORVERSION	dwMajorVersion
VER_MINORVERSION	dwMinorVersion
VER_PLATFORMID	dwPlatformId
VER_SERVICEPACKMAJOR	wServicePackMajor
VER_SERVICEPACKMINOR	wServicePackMinor
VER_SUITENAME	wSuiteMask
VER_PRODUCT_TYPE	wProductType

ComparisonType

TypeBitMask で指定された VersionInfo メンバーと、現在実行中のオペレーティングシステムの対応する属性を比較するために RtlVerifyVersionInfo が使用する比較の種類を指定します。

VER_SUITENAME以外のすべての TypeBitMask の値に対して、 ComparisonType は次のいずれかの値に設定されます。

値	意味
VER_EQUAL	現在の値は、指定した値と等しい必要があります。
VER_GREATER	現在の値は、指定した値より大きくする必要があります。
VER_GREATER_EQUAL	現在の値は、指定した値以上である必要があります。
VER_LESS	現在の値は、指定した値より小さくする必要があります。
VER_LESS_EQUAL	現在の値は、指定した値以下である必要があります。

TypeBitMask が VER_SUITENAME に設定されている場合、ComparisonType は次のいずれかの値に設定されます。

値	意味
VER_AND	wSuiteMask メンバーで指定されたすべての製品スイートは、現在のシステムに存在している必要があります。
VER_OR	指定された製品スイートのうち少なくとも 1 つが現在のシステムに存在している必要があります。

戻り値

RtlVerifyVersionInfo は 、次のいずれかの状態値を返します。

リターンコード	説明
STATUS_SUCCESS	指定したバージョンは、現在実行中のオペレーティングシステムのバージョンと一致します。
STATUS_INVALID_PARAMETER	入力パラメーターが無効です。
STATUS_REVISION_MISMATCH	指定したバージョンが、現在実行中のオペレーティングシステムのバージョンと一致しません。

注釈

RtlVerifyVersionInfo を使用すると、ドライバーはオペレーティングシステム属性の必要なセットの存在を簡単に確認できます。 RtlVerifyVersionInfo は、Windows SDK のユーザーモード VerifyVersionInfo 関数と同等のカーネルモードです。システムのバージョンを確認する方法を示す Windows SDK の例を参照してください。

通常、 RtlVerifyVersionInfo は、すべての比較が成功した場合にのみSTATUS_SUCCESSを返します。ただし、メジャーバージョン、マイナーバージョン、および Service Pack バージョンは、次の方法で順次テストされます。

メジャーバージョンが必要な最小数を超えた場合、マイナーバージョンとサービスパックのバージョンはテストされません。たとえば、現在のメジャーバージョンが 6.0 の場合、バージョン 5.1 Service Pack 1 以上のシステムのテストは成功します。マイナーバージョンと Service Pack バージョンはテストされません。
マイナーバージョンが必要な最小数を超えた場合、Service Pack のバージョンはテストされません。たとえば、現在のメジャーバージョンが 5.2 の場合、バージョン 5.1 以上のシステムバージョンの Service Pack 1 のテストは成功します。 Service Pack のバージョンはテストされていません。
メジャーサービスパックのバージョンが最低限必要なバージョンを超える場合、マイナーサービスパックのバージョンはテストされません。

システムバージョンの範囲を確認するために、ドライバーは RtlVerifyVersionInfo を 2 回呼び出し、1 回はシステムバージョンの下限を確認し、1 回はシステムバージョンの上限を確認できます。

要件

要件	値
対象プラットフォーム	ユニバーサル
Header	wdm.h (Ntddk.h を含む)
Library	NtosKrnl.lib
[DLL]	NtosKrnl.exe (カーネルモード);Ntdll.dll (ユーザーモード)
IRQL	PASSIVE_LEVEL

こちらもご覧ください

RTL_OSVERSIONINFOEXW

RTL_OSVERSIONINFOW

RtlGetVersion