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)