DirectX Dump Files

DirectX Dump Files を使用すると、GPU クラッシュを再現せずに、発生した後にそれを調査できます。 Windows がタイムアウト検出と復旧 (TDR) を通じて GPU のハングまたは障害を検出すると、DirectX ランタイムは、クラッシュ時点の GPU の状態を記録する .dxdmp ファイルを書き込みます。 PIX でファイルを開くか、PIX API を使用して処理できます。

ダンプ ファイルに含まれる内容

DirectX ダンプ ファイルには次のものを含めることができます。

  • 実行されていたシェーダー ウェーブ、そのレジスタ、障害のある命令などのハードウェアの状態とドライバー データ。
  • API オブジェクト、リソース、Device Removed Extended Data (DRED) 階層リンク、ページ フォールト データなど、Direct3D のランタイム状態。
  • GPU がフレームを通過した距離を示す PIX マーカーとドライバー イベント。
  • ダンプの作成時にアプリケーションで追加される最大 2 MB のデータ。
  • アダプター、ドライバー、OS、デバイス構成などのシステム情報。

完全および部分的なダンプ ファイル

ダンプ ファイルに含まれるハードウェアおよびドライバー データの量は、グラフィックス ドライバーによって異なります。

  • フル ダンプ ファイルは、DirectX Dump Files をサポートするドライバーから取得されます。 これらにはハードウェアの状態とドライバー データが含まれるため、PIX は、実行中のシェーダー ウェーブ、障害のある命令、ページ フォールトに関連するリソースを表示できます。
  • 部分的ダンプ ファイル は、ドライバーのサポートがなくても、必要な OS と Agility SDK のサポートがあるハードウェア上に作成されます。 Direct3D ランタイム状態、DRED データ、アプリケーション データ、システム情報が含まれますが、ハードウェアの状態やドライバー データは含みません。

ドライバーのサポートと利用可能なデータは、GPU ベンダーとドライバーのバージョンによって異なります。

DRED との関係

DirectX Dump Files build on Device Removed Extended Data (DRED) 自動階層リンクやページ障害レポートなどの DRED 機能を有効にすると、そのデータはダンプ ファイルに含まれ、PIX はドライバー データと共にそれを表示します。

ワークフロー

  1. Direct3D 12 ダンプ ファイル API を使用して、アプリケーションのダンプ ファイルを構成します。 クラッシュの調査中に、PIX または D3DConfig の設定をオーバーライドすることもできます。 詳細については、「DirectX Dump Files の生成」を参照してください。
  2. TDR が発生すると、DirectX ランタイムは .dxdmp ファイルを書き込みます。 アプリケーションは、ファイル パスを通知を受け取り、独自のデータをファイルに追加できます。
  3. PIX でダンプ ファイルを開いて、クラッシュの原因を見つけます。 詳細については、「PIX での DirectX Dump Files の分析」を参照してください。
  4. 必要に応じて、PIX DxDmp コマンド ライン ツールまたは MCP サーバーを使用して、AI エージェントでダンプを調査します。 詳細については、「AI エージェントを使用した DirectX Dump Files の分析」を参照してください。
  5. 必要に応じて、PIX API を使用してダンプ ファイルを処理します (クラッシュ コレクション パイプラインの一部など)。 詳細については、「プログラムによる DirectX Dump Files の分析」を参照してください。

フィードバックを提供する

DirectX Dump Files に関するフィードバックを提供するには: