再頒布可能なフレームワーク コンポーネント

Note

ドライバーが Windows 10 のみをターゲットとする場合は、WDF を再配分したり、ドライバー パッケージに共同インストーラーを提供したりする必要はありません。 Windows 10 をターゲットにするには:

1. Visual Studio のプロジェクト設定プロパティページで、ドライバー設定 ->ターゲットOSバージョンの下で、Windows 10 以降を選択します。 これは、.vcxprojファイルに以下を追加することと同じです:

<PropertyGroup Label="Configuration">
<TargetVersion>Windows10</TargetVersion>

2. INF Manufacturer Sectionで、次のようにターゲット OS バージョンとして 10.0 を指定します：

[Manufacturer]
%MyMfg% = MyMfg, NTamd64.10.0

このトピックでは、 Windows Driver Kit (WDK) の一部として含まれる Microsoft 提供の再配分可能フレームワークの更新プログラムと、どれをドライバー パッケージに追加するかを決定する方法について説明します。

再配分可能フレームワークの更新により、オペレーティング システムに含まれるものよりも新しいフレームワーク バージョンで構築されたドライバーを実行できます。 たとえば、KMDF 1.11 は Windows 8 に含まれています。 ただし、Windows Vista または Windows 7 で KMDF 1.11 ドライバーを実行できます。 ただし、これを行う前に、KMDF 1.11 フレームワーク ライブラリが、以前のオペレーティング システム (この場合は それぞれKMDF 1.7 と KMDF 1.9) に含まれるフレームワーク ライブラリを置き換えることを確認する必要があります。 これを行うには、Microsoft が提供する共同インストーラーまたは .msu ファイルをドライバー パッケージと共に再配分します。

ドライバー パッケージに共同インストーラーまたは .msu を含める必要があるのはいつですか?

まず、ドライバーがサポートする Windows のバージョンを決定します。 これに基づいて、使用するフレームワークのバージョンを決定します。

選択した WDF バージョンがターゲット OS に付属しているバージョンよりも新しい場合は、共同インストーラーまたは .msu ファイルをドライバー パッケージに含めます。

たとえば、ドライバーをWindows 7 で実行したいとします。 WDF 1.11 と WDF 1.9 のいずれかを使用してドライバーを構築することを選択できます。 Windows 7 で提供されている 1.9 を選択した場合、システムを更新する必要はありません。 一方、1.11 を選択した場合は、ドライバーに WDF 1.11 更新プログラム パッケージを含める必要があります。

共同インストーラーまたは .msuファイルを含める必要がありますか?

新しいハードウェア デバイスをシステムに接続することによってドライバーのインストールがトリガーされ、ドライバーのみをインストールする場合は、ドライバー パッケージに共同インストーラーを含めます。 次に、Specifying the KMDF Co-installer in an INF Fileの説明に従って、INF ファイル内で共同インストーラーを参照します。

ドライバーに加えてアプリケーションをインストールする必要がある場合は、代わりに、関連する MSU パッケージ (kmdf-1.11-Win.6.0.msuなど) とそれを呼び出すセットアップ アプリケーションを共に再配分する必要があります。 この場合、INF エントリは必要ありません。

共同インストーラーと .msu ファイルの両方が必要になることはありません。

これらのファイルはどこで見つけられますか?また、何が含まれていますか?

共同インストーラーは%program files%\Windows Kits\<version>\redist\wdfにあります。

このディレクトリには、x86 および x64 用の次のファイルが含まれています。

• WdfCoinstaller01007.dll、WdfCoinstaller01009.dll、WdfCoinstaller01011.dll (KMDF 1.7/1.9/1.11 の共同インストーラー)。
• WUDFUpdate_01007.dll、WUDFUpdate_01009.dll、WUDFUpdate_01011.dll (UMDF の共同インストーラー)。
• winusbcoinstaller.dll、winusbcoinstaller2.dll (WinUSB 1.5/1.9 の共同インストーラー)。

MSU ファイルが必要な場合は、WDK 8 再配分可能コンポーネントからパッケージ (MSI 形式) をダウンロードしてインストールしてください。 インストール後、MSU と共同インストーラーは%program files%\Windows Kits\8.0\redist\wdfに見つけられます。

共同インストーラーの名前付けとバージョン管理

共同インストーラーの名前は WdfCoInstallerMMmmm.dllです。

• MMはメジャー バージョン番号です。
• mmmはマイナー バージョン番号です。

たとえば、共同インストーラーのバージョン 1.0 のファイル名は WdfCoInstaller01000.dllであり、バージョン 1.11 のファイル名は WdfCoInstaller01011.dllです。

ドライバー パッケージに含める共同インストーラーのバージョンは、ドライバーの開発に使用するフレームワーク ライブラリのバージョンと一致している必要があります。

フレームワーク ライブラリのファイル名には、メジャー バージョン番号のみが含まれていることに注意してください。 ライブラリ ファイル名の詳細については、Framework Library Versioningをご参照ください。