WdfDriverIsVersionAvailable 関数 (wdfdriver.h)

  • [アーティクル]

[KMDF と UMDF に適用]

WdfDriverIsVersionAvailable メソッドは、ドライバーが指定したバージョンの Kernel-Mode Driver Framework ライブラリで実行されているかどうかを示すブール値を返します。

構文

BOOLEAN WdfDriverIsVersionAvailable(
  [in] WDFDRIVER                            Driver,
  [in] PWDF_DRIVER_VERSION_AVAILABLE_PARAMS VersionAvailableParams
);

パラメーター

[in] Driver

以前の WdfDriverCreate または WdfGetDriver の呼び出しからドライバーが取得したドライバーのフレームワーク ドライバー オブジェクトへのハンドル。

[in] VersionAvailableParams

フレームワーク ライブラリのバージョンを識別する WDF_DRIVER_VERSION_AVAILABLE_PARAMS 構造体へのポインター。

戻り値

ドライバーが VersionAvailableParams パラメーターで指定されているライブラリのバージョンで実行されている場合、WdfDriverIsVersionAvailable は TRUE を返します。

指定したライブラリ バージョンでドライバーが実行されていない場合、またはWDF_DRIVER_VERSION_AVAILABLE_PARAMS構造体が無効な場合、メソッドは FALSE を 返します。

ドライバー ハンドルが無効な場合、システム バグ チェックが発生します。

注釈

ライブラリのバージョンの詳細については、「 Framework ライブラリのバージョン管理」を参照してください。

例

次のコード例では、予期しないライブラリバージョン番号が検出された場合にエラーを報告します。

WDF_DRIVER_VERSION_AVAILABLE_PARAMS ver;

WDF_DRIVER_VERSION_AVAILABLE_PARAMS_INIT(&ver, 1, 0);
if (!WdfDriverIsVersionAvailable(
                                 driver,
                                 &ver
                                 )) {
    DbgPrint("Unexpected library version.\n");
}

要件

要件 値
対象プラットフォーム ユニバーサル
最小 KMDF バージョン 1.0
最小 UMDF バージョン 2.0
Header wdfdriver.h (Wdf.h を含む)
Library Wdf01000.sys (KMDF);WUDFx02000.dll (UMDF)
IRQL PASSIVE_LEVEL
DDI コンプライアンス規則 DriverCreate(kmdf)、 KmdfIrql(kmdf)、 KmdfIrql2(kmdf)、KmdfIrqlExplicit(kmdf)

こちらもご覧ください

WDF_DRIVER_VERSION_AVAILABLE_PARAMS

WdfDriverCreate

WdfDriverRetrieveVersionString

WdfGetDriver