サンプル Profile-Guided 最適化 (SPGO) ビルドで使用するプロファイル データを含むサンプル プロファイル データベース (SPD) ファイルを指定します。
また、サンプル プロファイル データベースを読み取るための /SPD で指定された既定値またはファイルをオーバーライドするためにも使用されます。
Syntax
/SPDIN:filename
Argument
filename
最適化に使用するプロファイル データを含む .spd ファイルへのパスを指定します。 展開する場合、完全修飾パスは MAX_PATH (260 文字) を超えてはなりません。
ファイルが存在しない場合、リンカーは、データの収集に使用される空のファイルを作成します。
注釈
xperfを使用してパフォーマンス トレースを収集し、SPTAggregateを使用して変換し、SPDConvertを使用してデータを SPD ファイルにインポートした後、/SPDINと/SPGOを使用して最適化されたバイナリを生成します。
SPD ファイルに記録されるバイナリの GUID と有効期間は、SPT ファイルと一致する必要があります。 一致しない場合は、"SPD バージョンに互換性がありません" というエラーが表示されることがあります。 このエラーを診断するには、SPTDump /progidを使用して SPT ファイル内のバイナリ識別子を検査し、 SPD ファイルを検査します。 リンカーは、可能な限り有効な SPD ファイルを使用します。 プログラムの制御フローを変更しないコードに対する軽微な更新は許容されます。 変更されていない関数では、最適化のためにデータも使用されます。 有効な SPD を指定したが、それ以外の場合は関係のない SPD を指定した場合、プロセスは機能しますが、最適化に使用できるデータがない可能性があります。
/SPDEMBEDを/SPGOと共に使用して、ビルドによって生成された PDB ファイルに SPD データを埋め込みます。
/SPDを使用して、SPD ファイルの既定以外の名前または場所を指定します。
/SPDIN 指定すると、このオプションがオーバーライドされます。
SPGO ワークフローの詳細については、「 チュートリアル: サンプル Profile-Guided 最適化 (SPGO) を使用してパフォーマンスを向上させる」を参照してください。
Visual Studio 開発環境でこのリンカー オプションを設定するには
- プロジェクトの [プロパティ ページ] ダイアログ ボックスを開きます。 詳細については、「Set C++ コンパイラとビルド プロパティを Visual Studio で参照してください。
- [構成プロパティ]>[リンカー]>[コマンド ライン] プロパティ ページを選択します。
- [その他のオプション] ボックスに
/SPDIN:filenameを追加します。 [OK] を選択して変更を保存します。
このリンカーをコードから設定するには
- AdditionalOptionsを参照してください。
こちらも参照ください
MSVC リンカーのリファレンス
MSVC リンカー オプション
/SPD (サンプル プロファイル データベースの指定)
/SPDEMBED (サンプル プロファイル データベースの埋め込み)
/SPGO (サンプル Profile-Guided 最適化を有効にする)
チュートリアル: サンプル Profile-Guided 最適化 (SPGO) を使用してパフォーマンスを向上させる