/CGTHREADS (コンパイラ スレッド)
リンク時のコード生成を指定した場合に最適化とコード生成に使う cl.exe スレッドの数を設定します。
/CGTHREADS:[1-8]
引数
- number
cl.exe が使用できるスレッドの最大数で、1 から 8 の範囲。
解説
/CGTHREADS オプションは、リンク時のコード生成 (/LTCG) が指定された場合に、コンパイルの最適化およびコード生成のフェーズで cl.exe が並列で使用するスレッドの最大数を指定します。 既定では、cl.exe は /CGTHREADS:4 が指定されているかのように 4 つのスレッドを使用します。 より多くのプロセッサ コアが使用できる場合、より大きい number 値はビルド時間を改善できます。
ビルドでは複数のレベルの並列化を指定できます。 msbuild.exe スイッチ /maxcpucount は、並列で実行できる MSBuild プロセスの数を指定します。 /MP (複数のプロセスを使用したビルド) コンパイラ フラグは、ソース ファイルを同時にコンパイルする cl.exe プロセスの数を指定します。 /cgthreads コンパイラ オプションは、それぞれの cl.exe プロセスが使用するスレッドの数を指定します。 プロセッサは、プロセッサ コアの数しかスレッドを同時に実行できないため、これらすべてのオプションに、より大きな値を同時に設定するのは効果的ではなく、逆効果になる場合もあります。 プロジェクトを並列でビルドする方法の詳細については、「MSBuild での複数のプロジェクトの並行ビルド」を参照してください。
Visual Studio 開発環境でこのリンカー オプションを設定するには
プロジェクトの [プロパティ ページ] ダイアログ ボックスを開きます。 詳細については、「プロジェクトのプロパティの操作」を参照してください。
［構成プロパティ］、［リンカー］ フォルダーを選択します。
[コマンド ライン] プロパティ ページを選択します。
［追加オプション］ プロパティに /CGTHREADS:number (number は 1 から 8 の値) が含まれるように変更し、[OK] をクリックします。
このリンカーをコードから設定するには
- 「AdditionalOptions」を参照してください。