フレームワーク ライブラリのバージョン

このトピックでは、カーネルモード ドライバー フレームワーク (KMDF) ライブラリとユーザーモード ドライバー フレームワーク (UMDF) ライブラリのファイル名の名前付け規則について説明します。

KMDF

KMDF ライブラリの各バージョンには、メジャー バージョン番号とマイナー バージョン番号が割り当てられます。 ライブラリのファイル名には、メジャー バージョン番号が含まれています。 ファイル名の形式は次のとおりです。

Wdf<MajorVersionNumber>000.sys

メジャー バージョン番号は 2 文字を使用します。 たとえば、ライブラリのバージョン 1.0 のファイル名は Wdf01000.sys です。 バージョン 1.9、1.11 などにも Wdf01000.sys という名前が付けられ、ライブラリ ファイルの新しいマイナー バージョンごとに以前のバージョンのファイルが上書きされます。

システム上にあるフレームワークのバージョンよりも新しいバージョンの KMDF ライブラリを使用してドライバーをビルドした場合は、前者を更新する必要があります。 フレームワーク ライブラリの更新については、「再頒布可能フレームワーク コンポーネント」を参照してください。

(フレームワーク共同インストーラーのファイル名には、メジャー バージョン番号とマイナー バージョン番号の両方が含まれていることに注意してください。共同インストーラー ファイル名の詳細については、「KMDF 共同インストーラーの使用」を参照してください)。

ドライバーをビルドすると、MSBuild ユーティリティは、MSBuild ユーティリティが使用したライブラリのバージョン番号を含むスタブ ファイルにドライバーをリンクします。 オペレーティング システムがドライバーを読み込むと、フレームワークのローダーはドライバーのスタブのバージョン情報をチェックして、システム上にあるフレームワーク ライブラリのバージョンでドライバーが実行されるかどうかを判断します。

ドライバーが実行されているライブラリのバージョンを確認するために、ドライバーは WdfDriverIsVersionAvailable または WdfDriverRetrieveVersionString を呼び出すことができます。

WDF を使用すると、ドライバーを実行するバージョンとは異なるバージョンの Windows を使用してドライバーをビルドできます。 詳細については、「複数のバージョンの Windows 用の WDF ドライバーの構築」を参照してください 。

KMDF ライブラリのリリース履歴については、「KMDF バージョン履歴」を参照してください。

UMDF

KMDF と同様に、UMDF ライブラリのメジャー バージョン番号では 2 つの文字が使用されます。 ただし、メジャー バージョン番号は、UMDF バージョン 2.0 以降の UMDF ライブラリ ファイル名にのみ表示されます。

UMDF バージョン 2.0 の場合、UMDF ライブラリのファイル名は Wudfx02000.dll です。

UMDF バージョン 1.x の場合、UMDF ライブラリのファイル名は Wudfx.dll です。

KMDF ライブラリのリリース履歴については、「UMDF バージョン履歴」を参照してください。