> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ATG 圖形合作檢查清單

> 與 XBOX 進階技術小組合作處理 GPU 效能問題的檢查清單：聯繫前請先蒐集 PIX 擷取、符號、DXR 設定及重現步驟。

當您與 **XBOX 進階技術小組 (ATG)** 合作以縮小圖形效能問題的範圍時，您所提供資料的品質將決定意見回饋的品質。本檢查清單涵蓋您在合作前應蒐集的資訊，讓 ATG 能將會議時間用於深入分析，而不是花在熟悉狀況上。

<Note>
  在與 ATG 合作之前，請一律先透過您的開發人員關係聯絡人 / DPM。他們可以提供大量資源，可能在問題提報之前就協助您解決問題。
</Note>

## 準備 GPU 效能分析

### 1. 要傳送的內容

ATG 可以分析**您提供的 PIX 擷取**，也可以從您遊戲的組建自行進行 PIX 擷取。**強烈建議由您提供擷取**，如此 ATG 就能立即開始分析，而不必先架設遊戲、處理測試帳戶，以及尋找具代表性的遊戲位置。擷取時間越少 = 分析時間越多。

### 2. 事先傳送 PIX 擷取

請在排定的合作**數天前**提供 PIX 擷取。這讓 ATG 有時間確認資料完整，以及其 PIX 組建與您擷取時所用的版本相容。

### 3. 使用最新的 PIX 與 OS Recovery *(建議)*

最新的 PIX 與 OS Recovery 提供分析改進、穩定性修正、更快的反覆運算速度及新功能 (DXR、VRS)。您**不**需要安裝最新的 GDK 或重新建置遊戲，GDK Tools 另有單獨的下載。

### 4. 包含 XBOX Series S 擷取 *(建議)*

合作通常著重於 Series X。請加入 **Series S 擷取**，讓 ATG 能找出在 Series X 上不會出現的效能改善機會。

### 5. 在 GPU 擷取中包含著色器符號 *(建議)*

著色器符號可實現更深入的分析、著色器最佳化建議、著色器編譯器程式碼產生的意見回饋，以及 PIX **Shader Edit and Continue** 實驗。請使用 **Slim PDB** (以 `/Zs` 編譯)，其速度更快、檔案更小。您**不**需要另外提供 PDB 檔案；只要在 PIX 設定中正確設定 Symbols Path，儲存擷取時就會內嵌符號。

### 6. 最壞情況的 GPU 擷取 *(必要)*

GPU 擷取必須**能代表遊戲最吃力的場景**。這能讓效能問題容易識別，避免 ATG 遺漏重要問題，並產生優先順序更佳的建議清單。

### 7. 停用動態解析度縮放 *(必要)*

進行 GPU 擷取時，請停用動態解析度縮放。請在所有轉譯階段以**最高目標解析度**擷取，讓 ATG 看到每個階段真正的最壞情況成本。

### 8. 定義 PIX 具名事件 *(必要)*

PIX **標記與括號**是必要的。它們能讓 ATG 識別子系統、將工作對應至您的引擎，並迅速提供可執行的意見回饋。

### 9. 使用資源名稱 *(選擇性)*

使用 `ID3D12Object::SetName()` 為資源命名。為轉譯目標、紋理和緩衝區設定有意義的名稱，可讓每個繪製與分派的用途一目了然。

### 10. GPU Trace 擷取 *(建議)*

**PIX GPU Trace 擷取**是 XBOX Series X|S 上提供的輕量型分析擷取。它們會在遊戲執行時記錄多個畫面，並將 CPU/GPU/記憶體的互動納入考量。與 GPU Capture 不同，Trace 是**獨立完整的**，擷取檔案無需連線至開發套件即可重新播放。

### 11. PIX Timing 擷取 *(選擇性)*

當懷疑 CPU↔GPU 同步、呈現時間、畫面節奏或延遲有問題時，Timing 擷取很有用。

### 12. 為跨畫面非同步計算擷取兩個 GPU 畫面 *(建議)*

如果非同步計算橫跨兩個畫面 (畫面 N 結尾 → 畫面 N+1 開頭)，請包含**雙畫面擷取**，讓 ATG 看到完整的相依性鏈結。

### 13. DXR *(必要)*

在 PIX 中啟用 **Capture All GPU Mapped Memory**，讓整個加速結構都包含在內。根據預設，只會擷取 GPU 存取過的頁面，這不足以進行 DXR 分析。

在 2023 年 6 月之前的 GDK 上，請使用 `SetCompileTimeShaderPdbPathX` 為 DXR 產生著色器 PDB。

### 14. 先執行 PIX Checklist *(建議)*

PIX 包含 **Checklist** 功能，會標示 ATG 經常看到的常見 GPU 效能改善機會。在合作前修正這些問題，ATG 就能將會議時間用於更深入的分析，而非容易解決的問題。

## 摘要

高品質的效能資料是 ATG 合作是否有成效的最大關鍵。如有疑慮，請**提供更多資料**。ATG 首先要求的就是上述擷取，因此事先準備好可加速整個合作過程。

## 相關內容

* [ATG 合作概觀](/zh-TW/build/atg-engagement/atg-engagement)
* [ATG 系統合作檢查清單](/zh-TW/build/atg-engagement/atg-systems-engagement)
* [PIX for XBOX](/zh-TW/tools/tools-console/pix/pix)
* [PIX GPU 擷取](/zh-TW/tools/tools-console/pix/gpu/pix-gpu-capture)
* [PIX GPU Trace](/zh-TW/tools/tools-console/pix/gpu-trace/pix-gpu-trace-overview)
* [著色器編譯器](/zh-TW/tools/tools-console/shadercompiler/shader-compiler)
* [PIX3 API 參考](/zh-TW/reference/tools/pix3/pix3_members)


## Related topics

- [存取 GDK 資源與下載](/zh-TW/home/onboarding-access/access-resources.md)
- [NDA 主題目錄 - Microsoft Learn 線上連結](/zh-TW/nda/nda-topic-directory.md)
- [XBOX GDK 主機開發的 NDA 主題索引](/zh-TW/nda/nda-overview.md)
- [XBOX 合作夥伴加入流程:取得存取權限與發行](/zh-TW/home/onboarding.md)
- [遊戲重新指派上層](/zh-TW/publishing/game-publishing/concepts/reparenting.md)