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 はドライバー データと共にそれを表示します。
ワークフロー
- Direct3D 12 ダンプ ファイル API を使用して、アプリケーションのダンプ ファイルを構成します。 クラッシュの調査中に、PIX または D3DConfig の設定をオーバーライドすることもできます。 詳細については、「DirectX Dump Files の生成」を参照してください。
- TDR が発生すると、DirectX ランタイムは
.dxdmpファイルを書き込みます。 アプリケーションは、ファイル パスを通知を受け取り、独自のデータをファイルに追加できます。 - PIX でダンプ ファイルを開いて、クラッシュの原因を見つけます。 詳細については、「PIX での DirectX Dump Files の分析」を参照してください。
- 必要に応じて、PIX DxDmp コマンド ライン ツールまたは MCP サーバーを使用して、AI エージェントでダンプを調査します。 詳細については、「AI エージェントを使用した DirectX Dump Files の分析」を参照してください。
- 必要に応じて、PIX API を使用してダンプ ファイルを処理します (クラッシュ コレクション パイプラインの一部など)。 詳細については、「プログラムによる DirectX Dump Files の分析」を参照してください。
フィードバックを提供する
DirectX Dump Files に関するフィードバックを提供するには:
-
DirectX Discord サーバーの
#dxdmpチャンネルに参加してください。 - PIX で、ウィンドウ ツール バーのメール ボタンを選択して、プライベート フィードバックを送信します。
- Email dxdmpsupport@microsoft.com。