Skip to main content
以程式設計方式在 XBOX Series 主機上啟用即時 GPU 偵錯。目前即時偵錯僅限於著色器偵錯。我們計劃在不久的將來將其延伸至著色器以外的範圍,並提供即時命令緩衝區偵錯。 提供此 API 是為了能在需要時隨時啟用即時偵錯,而不僅是在 GPU 停止回應且存在著色器波時。即時偵錯可用來檢查 GPU 的執行方式及檢查承載資料。請在呼叫需要偵錯其著色器的 ExecuteCommandLists 之前呼叫此 API。 此 API 可在圖形驅動程式的已驗證版本與已檢測版本上使用。如果在呼叫時已附加 CPU 偵錯工具或 PIX 已連線至開發套件,則會以程式設計方式啟用即時偵錯。 另外也提供類似的 API,可用於偵測擲回例外狀況的著色器,並即時加以偵錯。請參閱 EnableLiveDebuggingX

語法

參數

pDebugParams   _In_opt_
類型:D3D12XBOX_LIVE_DEBUGGING_PARAMETERS
可設定即時偵錯的類型,以及該偵錯類型特有的參數。目前即時偵錯僅限於著色器偵錯。我們計劃在不久的將來將其延伸至著色器以外的範圍,並提供即時命令緩衝區偵錯。

傳回值

類型:HRESULT 如果成功,會傳回 S_OK;否則會傳回 E_FAIL。 如果未附加 CPU 偵錯工具且 PIX 未連線,會傳回 E_NOINTERFACE。 在驅動程式的零售版本上會傳回 E_NOTIMPL,因為這是開發人員功能。

備註

如果在執行此 API 時既未附加 CPU 偵錯工具,PIX 也未連線至開發套件,則不會執行任何作業。 GPU 會暫停並搜尋指定類型與參數的著色器。找到時,必須啟動即時偵錯工作階段。如果找不到,GPU 會解除暫停,遊戲會繼續執行。在這兩種情況下,Visual Studio 輸出視窗中都會顯示訊息。 即時偵錯工作階段結束後,即時偵錯就會停用。您也可以使用 D3D12XBOX_LIVE_DEBUGGING_NONE 類型呼叫此 API,以明確停用即時偵錯。 另外也提供類似的 API,可用於偵測擲回例外狀況的著色器,並即時加以偵錯。請參閱 EnableLiveDebuggingX

需求

必須呼叫 ReportGpuHaltX,才能偵測 GPU 暫停並啟動即時偵錯。 標頭: d3d12_xs.h
程式庫: d3d12_xs.lib
支援的平台: XBOX Series 主機

另請參閱

d3d12_xs 成員 ID3D12CommandQueue ReportGpuHaltX EnableLiveDebuggingX PIX 中的隨選即時偵錯 PIX 中的著色器例外狀況即時偵錯
Last modified on October 6, 2026