GPU キャプチャを C++ にエクスポートする

[C++ へエクスポート] は、GPU キャプチャを C++ プロジェクトに変換し、Direct3D 12 リソースを再作成し、キャプチャされた GPU 作業を再生します。 元のアプリとは別にプロジェクトをビルドして実行できます。

GPU ドライバーのバグが疑われるなど、レンダリングの問題をスタンドアロンで再現するための出発点として、エクスポートしたコードを使用します。 生成された呼び出しを編集して変更を試したり、関連のない作業を手動で削除して再現を減らすことができます。

PIX からのエクスポート

  1. エクスポートする GPU キャプチャを開き、それをアクティブなドキュメントにします。
  2. [ファイル] メニューの [<キャプチャ名>" を C++ にエクスポートする] を選択します。
  3. [ C++ にエクスポート ] ダイアログで、[ エクスポート パス] を保存先フォルダーに設定します。 以前のエクスポートでファイルが上書きされないようにするには、まだファイルが含まれていないフォルダーを選択してください。
  4. 以下に説明する [エクスポート オプション ] を選択し、[ エクスポート] を選択します。
  5. エクスポートが成功したら、PIX で出力フォルダーを開く場合は、[ はい ] を選択します。

エクスポート コマンドは、GPU キャプチャがアクティブなドキュメントである場合に使用できます。 エクスポートが失敗した場合、PIX はエラー コードを表示します。

エクスポート オプション

ダイアログでは、次の設定が提供されます。

設定 機能
エクスポート パス PIX が生成されたプロジェクトとそのデータ ファイルを書き込む場所を選択します。
既存のファイルを上書きする 空でない宛先フォルダーの確認をスキップします。 一致する名前の既存のファイルは上書きできます。 これをオフのままにすると、PIX は空でないフォルダーに進む前に確認を求めます。
WinPixEventRuntime* を使用する 生成されたグラフィックス コマンド リストとコマンド キューの PIX イベントとマーカーを有効にします。 CMake は、WinPixEventRuntime パッケージの依存関係を構成します。 これがない場合、生成されたマーカー呼び出しはコンパイルされません。
DirectX 12 Agility SDK の使用** DirectX 12 Agility SDK パッケージを取得し、その Direct3D ヘッダーとランタイムを使用するようにプロジェクトを構成します。 ビルドによって、実行可能ファイルの横の D3D12 サブフォルダーにランタイムがコピーされます。 このオプションを指定しないと、プロジェクトでは Windows SDK ヘッダーとシステム Direct3D ランタイムが使用されます。
再生時の ExecuteIndirect 引数バッファーを使用する (実験的) キャプチャ時に記録されたコピーではなく、リプレイ中に生成された引数バッファーを使用します。 アプリで、同期を維持する必要がある他のバッファーと一緒に非決定的に引数バッファーを生成し、既定のエクスポートによって破損やクラッシュが発生する場合は、この方法を試してください。

2 つのパッケージ オプションのアスタリスクは、ライセンス確認を示します。 いずれかのオプションを選択すると、そのパッケージのライセンスを確認し、承諾したことになります。ダイアログは、NuGet.org の用語にリンクします。

PIX が生成するもの

エクスポートは CMake プロジェクトであり、事前構築済みの実行可能ファイルまたは Visual Studio ソリューションではありません。 次のファイルが含まれます。

ファイル 用途
CMakeLists.txt PixCapturePlayer ビルド ターゲットとオプションのパッケージの依存関係を定義します。 CMake を使用して Visual Studio ソリューションを生成できます。
Main.cpp および Win32Application.cpp Windows アプリケーションのエントリ ポイントと再生ループを指定します。
FrameResources*.cpp、 CreateAndInitResources*.cpp、および CreatePSOs.cpp キャプチャされたリソースとパイプライン状態を再作成します。
CommandLists*.cpp および RenderFrame*.cpp コマンド リストを記録し、キャプチャされた作業を実行します。
Descriptors*.cpp、 ModifyDescriptors*.cpp、および ResourceModifications*.cpp 記述子を再作成し、キャプチャされた更新プログラムを適用します。
resources.bin 生成されたコードが実行時に読み取るリソースの内容やシェーダー バイトコードなどの圧縮バイナリ データを格納します。
ヘッダーとソース ファイルをサポート d3dx12 ヘッダーを含むリソースの読み込みヘルパーと再生ヘルパーを提供します。

PIX では、生成された大規模なソース ファイルが、 CommandLists_000.cpp などの番号付きファイルに分割されます。 プロジェクトを共有または移動するときは、エクスポート全体をまとめたままにします。C++ ファイルだけでは十分ではありません。

ビルドと実行

x64 Visual Studio ビルドの場合は、次をインストールします。

  • Visual Studio と MSVC ツールを含む C++ によるデスクトップ開発 ワークロード。
  • 生成されたコードで使用される宣言を提供する Windows SDK。 プロジェクトは CMake に、インストールされている最新の Windows SDK を選択するように要求します。
  • CMake 3.30 以降。 プロジェクトには C++17 が必要です。

次の例では、Visual Studio 2022 を使用します。 x64 開発者コマンド プロンプトから、エクスポートされたフォルダーに移動し、次を実行します。

cd /d C:\Exports\Frame
cmake -G "Visual Studio 17 2022" -B out\build -A x64
cmake --build out\build --config Release

いずれかのパッケージ オプションを選択した場合、CMake はプロジェクトの構成時に NuGet からパッケージをダウンロードしようとします。 その手順のネットワーク アクセスを許可し、構成出力でダウンロードの警告をチェックします。

生成された実行可能ファイルを out\build\Release から実行するか、生成されたソリューションを out\build で開いて、 PixCapturePlayer ターゲットを実行します。 ターゲット名は PixCapturePlayer のままですが、実行可能ファイルは通常、キャプチャされたアプリの名前を取得します。 PIX では、代わりにキャプチャ ファイル名を使用できます。 PixCapturePlayer.exe がフォールバックです。

生成されたアプリケーションは、キャプチャされた作業を繰り返し再生します。 変更されていないエクスポートから始めて、コードを簡略化する前に問題が再現されることをチェックします。

実行時に resources.bin を使用できるようにします。 リーダーは作業ディレクトリと最大 3 つの親ディレクトリを検索し、ビルド時に記録されたエクスポート ディレクトリにフォールバックします。 ビルドされた複製を移動するときは、 resources.bin をその作業ディレクトリに配置し、生成されたランタイム依存関係を含めます。

  • WinPixEventRuntime.dll(有効な場合)。
  • D3D12 サブフォルダー (Agility SDK が有効になっている場合)。

制限事項

  • マルチアダプター C++ エクスポートはサポートされていません。 PIX は、異なるアダプターの記述を持つデバイスを作成するキャプチャを拒否します。
  • 生成されたアプリケーションは、キャプチャ時の説明を持つアダプターを使用しようとし、見つけられない場合は、既定のアダプターにフォールバックします。 ドライバー バグを再現する場合は、元のハードウェアで開始し、別の GPU で使用するために共有する前に結果を検証します。

コマンド ラインからのエクスポート

pixtool を使用して GPU キャプチャを開き、同じセッションでエクスポートします。

pixtool open-capture C:\Captures\Frame.wpix export-to-cpp C:\Exports\Frame

export コマンドは、次のスイッチを受け入れます。

スイッチ 同等のエクスポート オプション
--force 一致する名前でファイルを上書きします。 出力ディレクトリが空でない場合は必要です。
--use-winpixeventruntime WinPixEventRuntime を使用し、そのライセンスに同意します。
--use-agilitySdk DirectX 12 Agility SDK を使用して、そのライセンスに同意します。
--use-replay-time-executeindirect-buffers replay-time ExecuteIndirect 引数バッファーを使用します。

たとえば、両方のオプション パッケージを含んでエクスポートするには、次のようにします。

pixtool open-capture C:\Captures\Frame.wpix export-to-cpp C:\Exports\Frame --use-winpixeventruntime --use-agilitySdk

UI とは異なり、 pixtool は空でないディレクトリに書き込む前にプロンプトを表示しません。 --force を指定しない限り、コマンドは失敗します。