XBOX GDK 主機開發的 NDA 主題索引 - XBOX Game Development Documentation

此索引上的每個頁面都需要有效的 XBOX GDK for Console Development NDA。所有頁面都會從主要側邊欄導覽中隱藏。下列項目僅依標題列出，且未建立連結；已通過 NDA 審核的讀者可以透過 GDKX 存取這些頁面。

關於本節

NDA Topics 索引標籤將每個機密的 XBOX GDK 主機開發頁面集中在單一索引標籤中，讓具有 NDA 存取權的作者和讀者能一目了然地看到完整內容。頁面會分組為各個區段，與這些主題在文件其他部分所在的索引標籤相對應：

Home — 開發套件設定、開發套件設定值，以及整個工作室範圍的設定。
Build — 主機功能 (音訊、記憶體、儲存)、核心圖形功能、遊戲原則，以及 ATG 合作。
Tools — PIX、著色器編譯器、命令列、DevHome、hix 和其他主機工具頁面。
API References — GDK 圖形 API 參考標頭，以及隱藏的系統/工具 API 群組。

Home

來自文件 Home 索引標籤的機密頁面 — 包含設定、啟用及設定 XBOX 開發套件所需的一切。

設定與安裝

概念

頁面	描述
產品權限	透過 Partner Center 沙箱，授與使用者、群組和開發套件對產品的存取權。
部署	部署類型 (Push、Run from PC、Streaming Install) 和工具 (XBOX Manager、xbapp、Visual Studio)。
緊急離線更新	當開發套件無法開機時，從 USB 執行 EOU 原廠重設。
非預期的重新開機	診斷 XBOX 開發套件非預期重新開機或關機的原因。
通用錯誤訊息	XBOX 開發套件上常見的通用錯誤訊息 (UEM) 及各自的解決方法。
移除 Gold Sharing	重設主機權限，以從開發套件清除 Gold Sharing。
XBOX One X 開發套件秘訣	XBOX One X 開發套件的工具、更新、指令碼和前面板秘訣。
主機模式	透過切換主機模式來模擬其他 XBOX 平台。

開發套件設定

頁面	描述
零售 ↔ 開發人員模式	在零售模式與開發人員模式之間切換 XBOX 開發套件。
設定設定值	透過 DevHome、xbconfig 或 XBOX Manager 設定 Profiling Mode、Sandbox ID 和閒置逾時。
刷寫 OS 復原	註冊自動 OS 復原更新，或手動套用復原映像。
設定主機名稱	為開發套件指定易記的主機名稱，讓工具在 IP 變更後仍可運作。

整個工作室範圍的設定

頁面	描述
復原多部主機	從一部 PC 對多個開發套件平行執行 OS 復原。
自動復原更新	自動 OS 復原更新的運作方式，以及如何變更更新原則。
自動設定指令碼	撰寫用於 OOBE、每次開機設定或臨時執行的自動設定指令碼。

Build

來自文件 Build 索引標籤的機密頁面 — 主機功能、核心圖形功能、遊戲原則，以及 Microsoft 合作檢查清單。

主機功能

位於其他公開 Build 群組內的隱藏 NDA 頁面。每一列會列出該群組的進入點；其中的個別 NDA 頁面可從該登陸頁面或透過直接連結存取。

群組	描述	進入頁面
音訊	適用於 XBOX GDK 的 XAudio2 概觀和相關音訊指引。	XAudio2 概觀
記憶體	XBOX 主機的核心和系統記憶體使用量、虛擬記憶體配置器、可寫入的檔案對應，以及移植/診斷。	系統記憶體概觀
儲存 — DirectStorage	機密的 DirectStorage 指引：壓縮、重組 (shuffle) 和白皮書。	DirectStorage 概觀

核心功能

圖形

Core Features → Graphics 樹狀結構的大部分內容都受 NDA 保護。每一列是 build/core-features/graphics/ 下的一個隱藏子群組或一組隱藏的最上層頁面。

群組	描述	進入頁面
D3D12X	XBOX Direct3D 12 (D3D12X) 概觀、與 PC 的差異、ATOC，以及 XMemAlloc 物件類型。	D3D12X 概觀
DirectX (主機特定)	僅限主機的 DirectX 主題：色彩與深度壓縮、建立旗標、畫面排程、硬體重疊、原生資源管理、晶片外鑲嵌、暫停與繼續。	色彩與深度壓縮
圖形概觀	機密的圖形概觀頁面 (GPU 概觀、增強型屏障、Scarlett 上的 GPU 同步處理、HDR 支援、120 Hz、CMask 解碼、螢幕區域)。	GPU 概觀
圖形簡報 — XDD 2024	XDD 2024 圖形深入探討。	簡報
圖形簡報 — XFEST 2019	XFEST 2019 圖形簡報。	簡報
圖形簡報 — XFEST 2022	XFEST 2022 圖形簡報。	簡報
新功能 — 網格著色器	網格著色器 API 設計、meshlet 剔除與轉譯、Scarlett 支援、使用方式和設計原理。	網格著色器概觀
新功能 — 光線追蹤	XDXR 概觀、BVH 建置器、壓縮、硬體設計、KDOP、離線 RT PSO、獨立式、最佳做法。	光線追蹤概觀
新功能 — Sampler Feedback / SFS	Sampler Feedback Streaming API 和 GPU 設計、概觀、使用方式和設計原理。	SFS 概觀
新功能 — VRS	Variable Rate Shading API、功能、概觀和設計原理。	VRS 概觀
新功能 — XBTC	XBOX Texture Compressor、封存格式、JSON 批次設定和使用方式。	XBOX Texture Compressor
白皮書	機密的圖形白皮書 (棋盤式轉譯、快取與一致性、VMEM 指令、Series S 最佳化、動態解析度、ESRAM 管理員、GPU 計算單元、GPU 記憶體存取、佔用率快速參考、GPU 概觀)。	XBOX One GPU 概觀
圖形 — 最上層	其他隱藏的最上層圖形頁面：Dolby Vision、影像處理、Scarlett 紋理配置、圖形記憶體概觀、圖形 PSO 概觀，以及 graphics-newfeatures 目錄。	圖形記憶體概觀

遊戲原則

永續性

頁面	描述
永續性概觀	適用於 GDK 遊戲之 XBOX 永續性指引的機密概觀。

安全性

頁面	描述
通訊安全性概觀	網路通訊的機密性、完整性和驗證需求。
遊戲安全性概念	安全性概念和常見攻擊類別的概觀。
開發工具安全性	自訂遊戲開發工具的安全性指引。
一般遊戲安全性	設計層級的安全性 — PII 保護和安全性測試。
安全的遊戲通訊	GDK 遊戲中每種流量類型的建議安全方法。
安全的遊戲網狀架構	點對點和用戶端/伺服器安全通訊指引。
安全通訊範例	用於安全通訊的 GDK 和 XBOX services 範例。
安全的 Web 要求	適用於 HTTPS 和 WebSocket 的建議 API、驗證和 TLS。

ATG 合作

頁面	描述
ATG 合作	與 Microsoft 的 Advanced Technology Group 合作以取得平台支援。
圖形合作	就 GPU 效能問題與 ATG 合作的檢查清單。
系統合作	就 CPU、系統、記憶體和載入問題與 ATG 合作的檢查清單。

Optimize

來自文件 Optimize 索引標籤的機密頁面 — 位於其他公開 Tools 群組內的隱藏主機工具頁面。每一列會列出該群組的進入點；其中的個別隱藏頁面可從進入頁面或透過直接連結存取。

工具 (主機)

群組	描述	進入頁面
PIX	PIX for XBOX 工具鏈：最上層 UI 和工作流程，以及 GPU、GPU Trace、擴充性和著色器總管子群組。	PIX
命令列工具	機密的命令列工具：`xbconfig`、`xbperf`、`xbttd` 及相關公用程式。	xbconfig
DevHome	機密的 DevHome 頁面 (效能檢視)。	DevHome 效能
hix	`hix` 著色器檢查工具及其即時偵錯工作流程。	hix
著色器編譯器 (DXC)	XBOX DXC 使用方式、擴充功能、內建函式、定義、從 FXC 移植，以及著色器編譯器概觀。	著色器編譯器
titleperfoverlay	`titleperfoverlay` 螢幕效能重疊。	titleperfoverlay
xhit	`xhit` 硬體指令工具。	xhit 工具

API References

來自文件 API References 索引標籤的機密頁面 — 隱藏的 GDK 圖形 API 參考標頭，以及隱藏的系統和工具 API 群組。本節下的每個群組和頁面都會從側邊欄中隱藏。每個標頭的成員頁面是其介面、結構、列舉和函式的進入點。

圖形

群組	描述	進入頁面
圖形參考目錄	機密 GDK 圖形 API 參考的目錄。	圖形參考目錄

圖形 API

標頭	描述	成員頁面
d3d12_x	適用於 XBOX One 系列的 Direct3D 12 — 介面、結構、列舉和函式。	d3d12_x 成員
d3d12shader_x	XBOX D3D12 的著色器反映介面。	d3d12shader_x 成員
d3d12video_x	硬體視訊解碼、編碼和處理。	d3d12video_x 成員
d3dx12_x	適用於 XBOX One 系列的僅標頭 D3D12 協助程式庫。	d3dx12_x 成員
d3dx12_xs	適用於 XBOX Series 系列的僅標頭 D3D12 協助程式庫。	d3dx12_xs 成員
XG 參考	輔助圖形程式庫 — 資源配置、圖格和 mip 中繼資料。	XG 成員
XGMemory 參考	XBOX One 系列上的動態 ESRAM / 系統記憶體對應。	XGMemory 成員
XBTC	適用於 GDK 管線的離線 BC1–BC7 區塊壓縮。	XBTC 成員
xg_xs	XG 輔助圖形程式庫的 XBOX Series 變體。	xg_xs 成員
DXCApi	DirectX Shader Compiler API — 將 HLSL 編譯為 DXIL。	DXCApi 成員

系統 API

群組	描述	進入頁面
XMem	機密的 XMem 參考：成員頁面以及列舉、函式、巨集和結構。	XMem 成員

工具 API

群組	描述	進入頁面
PIX3	機密的 PIX3 頁面 (GPU 擷取、電源計量函式和結構)。	PIX3 GPU 擷取

​關於本節

​Home

​設定與安裝

​概念

​開發套件設定

​整個工作室範圍的設定

​Build

​主機功能

​核心功能

​圖形

​遊戲原則

​永續性

​安全性

​ATG 合作

​Optimize

​工具 (主機)

​API References

​圖形

​圖形 API

​系統 API

​工具 API

關於本節

Home

設定與安裝

概念

開發套件設定

整個工作室範圍的設定

Build

主機功能

核心功能

圖形

遊戲原則

永續性

安全性

ATG 合作

Optimize

工具 (主機)

API References

圖形

圖形 API

系統 API

工具 API