プラットフォーム ツールセット

Windows Driver Kit (WDK) は、MSBuild プラットフォーム ツールセットの機能を生かして、ドライバー開発固有のツールとライブラリを提供します。 MSBuild プラットフォーム ツールセットの機能は拡張することができます。 使用する必要がある特定バージョンのプラットフォーム ツールセットは、PlatformToolset という MSBuild プロパティで制御されます。 プロジェクトは、プロジェクト ファイルで PlatformToolset プロパティを設定することで、ツールとライブラリを切り替えることができます。

Windows Driver Kit (WDK) 8.1 には、ドライバー開発用の次のプラットフォーム ツールセットが用意されています。

Windows Driver Kit (WDK) 8 には、ドライバー開発用の次のプラットフォーム ツールセットが用意されていました。 この情報は参照用にのみ提供されています。

注 Visual Studio で入手可能な Windows ドライバー テンプレートの 1 つからドライバーを作成すると、PlatformToolset プロパティが設定されます。 Visual Studio のドライバー プロジェクトのプロパティ ページを使用して、PlatformToolset を選択することもできます。 Visual Studio でのプラットフォーム ツールセットの設定

1. ドライバー プロジェクトのプロパティ ページを開きます。 ソリューション エクスプローラーでドライバー プロジェクトを長押し (または右クリック) し、[プロパティ] を選びます。
2. ドライバー プロジェクトのプロパティ ページで、Configuration Properties、General の順に選択します。
3. ドロップダウン リストからプロジェクトの Platform Toolset プロパティを選択します。

例 - Visual Studio プロジェクト ファイル (.vcxproj) での PlatformToolset プロパティの設定

次の例で、プロジェクト ファイルでの PlatformToolset プロパティの設定方法を示します。

<PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Debug|Win32'"
      Label="Configuration">
  <ConfigurationType>Driver</ConfigurationType>
  <DriverType>KMDF</DriverType>
  <PlatformToolset>WindowsKernelModeDriver8.1</PlatformToolset>
</PropertyGroup>

ConfigurationType プロパティは、ビルドされるバイナリのターゲット拡張機能と出力の種類を制御します。 このプロパティに使用できる値の中には、Application、DynamicLibrary、StaticLibrary、Utility があります。

WDK には、カーネルモードのドライバーをビルドするために、Driver というこのプロパティ用の新しい値が導入されています。 このプロパティを Driver に設定すると、MSBuild で、拡張子 .sys が付くドライバー ファイルが生成されます。 この例では、PlatformToolset プロパティを WindowsKernelModeDriver8.1 に設定して、カーネルモードのドライバーをビルドします。 WindowsKernelModeDriver8.1 は、DriverConfigurationType を必要とする唯一の WDK プラットフォーム ツールセットです。 この例では、DriverType が KMDF に設定されています。

ドライバーの PlatformToolset プロパティについて

PlatformToolset は、プロパティ シート、ターゲット、ツール、タスクのセットであり、特定のプラットフォームのドライバーまたはカーネルモードのコンポーネントをビルドするために、連携してプラットフォームの拡張や変更を行います。 ドライバーと、関連するコンポーネントやアプリケーションの場合、プロジェクト ファイルで PlatformToolset プロパティを WindowsKernelModeDriver8.1、WindowsUserModeDriver8.1、WindowsApplicationForDrivers8.1 のいずれかに設定する必要があります。 これらのプラットフォーム ツールセットは、既存の Visual Studio C\C++ ツール チェーン コンパイラとリンカーを他の WDK 固有のビルド ツールで拡張し、WDK ヘッダーとライブラリをターゲットにするように設計されています。 WindowsApplicationForDrivers8.1 ツールセットは、WDK for Windows 7 (WDK 7.1) で使用可能だったビルド オプション設定との互換性を提供し、ドライバーと対話するユーザー モードのアプリケーションの開発に一般的とされている既定の設定も提供します。

プラットフォーム ツールセットには既定のプラットフォーム レベルの設定があり、ドライバー プロジェクトをビルドすることを目標としています。 コンパイラやリンカーなどのビルド ツール、WDK の INCLUDE パスや LIBRARY パスなどのシステム情報、Unicode または ANSI 文字列を使用してドライバー プロジェクトを構築するときに設定するさまざまなプロパティなどの機能設定には、既定のスイッチを使用します。 デスクトップ用の Windows アプリケーションを開発する場合は、WindowsKernelModeDriver8.1、WindowsUserModeDriver8.1、または WindowsApplicationForDrivers8.1 プラットフォーム ツールセットを使用しないでください。 代わりに、Visual Studio 2013 (v120) プラットフォーム ツールセットを使用してください。

既定では、新しく作成された Win32 ユーザー モード C++ プロジェクトと Visual Studio 2013 に変換されたプロジェクトの両方で、PlatformToolset プロパティは Visual Studio 2013 (v120) です。 どちらの場合も、PlatformToolset プロパティはプロジェクト ファイルに書き込まれません。

ドライバーのプラットフォーム ツールセットのいずれかを選択すると、次のプロパティが設定されます。

• ExecutablePath と NativeExecutablePath (PATH)
• IncludePath (INCLUDE)
• ReferencePath (LIBPATH)
• LibraryPath (LIB)
• SourcePath
• ExcludedPath

注UseEnv が TRUE に設定されていない場合、PATH、LIB、INCLUDE、LIBPATH は、プラットフォーム ツールセットの対応するプロパティの値から設定されます。 UseEnv が TRUE に設定されている場合は、古いビルド システムと同様に、PATH、INCLUDE、LIB、LIBPATH の環境変数の値が代わりに使用されます。

ドライバー固有のプラットフォーム ツールセットを有効にするファイルを WDK がインストールする場所

次の表は、ドライバー開発用のプラットフォーム ツールセットを有効にするために、WDK がファイルをインストールする場所をまとめたものです。