プログラムによる DirectX Dump Files の分析

PIX API を使用して、PIX UI なしで DirectX Dump Files を読み取るカスタム ツールを構築できます。 たとえば、受信ダンプ ファイルを原因別に並べ替えたり、各ダンプ ファイルから障害のあるシェーダーを抽出したりできます。

カスタム実装が必要ない場合は、PIX に付属するコマンド ライン ツールである DxDmp.exe を使用します。 CLI の詳細については、「 DxDmp ツール リファレンス」を参照してください。

ダンプ ファイルを開く

ダンプ ファイルを開くには、ファイルへのパスを使用して IPixFactory::OpenDxDumpFileDocument を呼び出します。 IPixDxDumpFileDocumentを返します。これにより、PIX のビューに表示されるのと同じデータにアクセスできます。これには以下が含まれます。

  • デバイスのエラー コード、エラー バケット、概要。
  • アプリケーション、アダプター、OS、および CPU の情報。
  • 有効になっていたダンプ ファイル ドライバー オプション。
  • DRED データ。
  • キューとそのイベント。
  • ページ フォールト。
  • リソースと Direct3D 12 API オブジェクト。
  • シェーダー ウェーブ、シェーダー、レジスタを実行します。
  • アプリケーション BLOB。

PIX API は、C++、C#、および Python で使用できます。 完全な API リファレンスについては、PIX インストール フォルダーで docs\html\index.html を開いてください。

サンプル

DXDumpFileParser サンプルは、ダンプ ファイルを開き、それに含まれるデータを出力します。 C++、C#、Python で使用できます。

ダンプ ファイルのメタデータ、エラー バケット、処理中のシェーダー、およびキュー イベントを示す DXDumpFileParser サンプル出力のスクリーンショット。