Nmake2MsBuild

  • [アーティクル]

注: Nmake2MsBuild ツールは、Windows 10 バージョン 1511 以降の WDK から削除されました。

Nmake2MsBuild ユーティリティは、ドライバーのソース コード ファイル、および sources、dirs、makefile.inc ファイルから、以前のバージョンの WDK を使用してビルドされたドライバー用の Visual Studio プロジェクトを生成します。 このユーティリティは、既存の sources ファイルと同じディレクトリに Visual Studio プロジェクト ファイルを作成します。 このユーティリティにより、ソース コードや以前のビルド ファイルが変更されることはありません。

このユーティリティの使用方法については、「WDK ソース ファイルから Visual Studio プロジェクトへの変換」を参照してください。

構文

Nmake2MsBuild.exe ユーティリティの構文は次のとおりです。

NMake2MSBuild.exe  < sources [<sources>...] | dirs >
                          [-Name:<Name of output project>]
                          [-Package:<Path to package project file to generate>]
                          [-Solution:<Path to Solution file to generate>]
                          [-Log:[<LogFile>]:[<Verbosity>]]
                          [-ConsoleLog:<Verbosity>]
                          [-NoPackageProject]
                          [-NoSolution]
                          [-SafeMode]

変換ツールは、%PROGRAMFILES%\Windows Kits\8.0\tools\x86\ ディレクトリにあります。

sources

WDK の以前のバージョンでビルドされたドライバーの sources ファイルへのパスを指定します。 sources ファイルを指定すると、ユーティリティはその sources ファイルと対応する makefile.inc を解析し、Visual Studio プロジェクト ファイルを生成します。 Visual Studio プロジェクト ファイルは、sources ファイルと同じディレクトリに配置されます。

一度に複数の sources ファイルを指定できます。 結果として得られるプロジェクトはすべて、同じソリューション プロジェクトとパッケージ プロジェクトを共有します。
dirs

WDK の以前のバージョンでビルドされたドライバーの dirs ファイルへのパスを指定します。 dirs ファイルを指定すると、ユーティリティはすべての sources ファイルと対応する makefile.inc ファイルのディレクトリ ツリーを検索し、それぞれに対して Visual Studio プロジェクト ファイルを生成します。
-Package:<生成するパッケージ ファイルへのパス> ドライバー パッケージ プロジェクト ファイルのカスタム名を指定します。
-Solution:<生成するソリューション ファイルへのパス> ドライバー ソリューション ファイル (.sln) のカスタム名を指定します。
-Log:[<LogFile>]:[<Verbosity>] ログ ファイルの名前を指定し、ログのレベルを指定します (「Verbosity」を参照)。
-ConsoleLog:<Verbosity> コンソール ログ ファイルの名前を指定し、ログのレベルを指定します (「Verbosity」を参照)。

-Name:<出力プロジェクトの名前>

生成される VcxProj ファイルのカスタム名を指定します。 または、dirs ファイルを変換する場合は、このパラメーターを使用して、生成されるソリューションの名前を指定します。
Verbosity ログ ファイルとコンソール ログの既定のログ記録レベルは、それぞれ、Verbose と Information です。 Verbosity は、System.Diagnostics.SourceLevels の 1 つです。
-SafeMode SafeMode では、NMAKE ターゲットに対する IDE/UI のサポートは提供されませんが、NMAKE ターゲットに対してより正確な変換が提供される可能性があります。 -SafeMode は、プロジェクトの NMAKE ターゲットで以前に実行されたビルド手順中に問題が発生した場合にのみ指定します。

コメント

変換ツールは、%PROGRAMFILES%\Windows Kits\8.0\tools\x86\ ディレクトリにあります。

応答 (.Rsp) ファイルは、コマンド ライン パラメーターを指定するためにサポートされています。 各パラメーターは、個別の行で指定する必要があります。

例

(Build.exe ならびに sources および dirs ファイルを使用して) WDK の以前のバージョンでビルドされたドライバー プロジェクトをビルドするには、最初に、Nmake2MsBuild.exe 変換ユーティリティを使用して VcxProj プロジェクトに変換する必要があります。

たとえば、以前に MyDriver と呼ばれる Windows 7 WDK でビルドされたドライバーを変換するには、最初に、Visual Studio コマンド プロンプト ウィンドウを開きます。 ディレクトリを参照するか、sources または dirs ビルド構成ファイルを含むディレクトリへのパスを指定します。 たとえば、次のコマンドは、sources ファイルと同じフォルダーに MyDriver.Vcxproj ファイルを生成します。

nmake2msbuild.exe  .\myDriver\sources

WDK ソース ファイルから Visual Studio プロジェクトへの変換

既にあるソース ファイルからのドライバーの作成