> ## 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.

# ID3D12Commandqueue::EnableLiveDebuggingX

> ID3D12Commandqueue::EnableLiveDebuggingX (XBOX Series 主機) — 以程式設計方式在 XBOX Series 主機上啟用即時 GPU 偵錯。

以程式設計方式在 XBOX Series 主機上啟用即時 GPU 偵錯。目前即時偵錯僅限於著色器偵錯。我們計劃在不久的將來將其延伸至著色器以外的範圍，並提供即時命令緩衝區偵錯。

提供此 API 是為了能在需要時隨時啟用即時偵錯，而不僅是在 GPU 停止回應且存在著色器波時。即時偵錯可用來檢查 GPU 的執行方式及檢查承載資料。請在呼叫需要偵錯其著色器的 ExecuteCommandLists 之前呼叫此 API。

此 API 可在圖形驅動程式的已驗證版本與已檢測版本上使用。如果在呼叫時已附加 CPU 偵錯工具或 PIX 已連線至開發套件，則會以程式設計方式啟用即時偵錯。

另外也提供類似的 API，可用於偵測擲回例外狀況的著色器，並即時加以偵錯。請參閱 [EnableLiveDebuggingX](/zh-TW/reference/graphics/d3d12_xs/interfaces/ID3D12Device11/methods/id3d12device11_enablelivedebuggingx)

## 語法

```cpp theme={null}
HRESULT EnableLiveDebuggingX(
  D3D12XBOX_LIVE_DEBUGGING_PARAMETERS * pDebugParams
)
```

### 參數

*pDebugParams*   \_In\_opt\_\
類型：[D3D12XBOX\_LIVE\_DEBUGGING\_PARAMETERS](/zh-TW/reference/graphics/d3d12_xs/structs/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](/zh-TW/reference/graphics/d3d12_xs/interfaces/ID3D12Device11/methods/id3d12device11_enablelivedebuggingx)

## 需求

必須呼叫 [ReportGpuHaltX](/zh-TW/reference/graphics/d3d12_xs/interfaces/ID3D12Device11/methods/id3d12device11_reportgpuhaltx)，才能偵測 GPU 暫停並啟動即時偵錯。

**標頭：** d3d12\_xs.h\
**程式庫：** d3d12\_xs.lib\
**支援的平台：** XBOX Series 主機

## 另請參閱

[d3d12\_xs 成員](/zh-TW/reference/graphics/d3d12_xs/d3d12_xs_members)

[ID3D12CommandQueue](/zh-TW/reference/graphics/d3d12_x/interfaces/id3d12commandqueue/id3d12commandqueue)

[ReportGpuHaltX](/zh-TW/reference/graphics/d3d12_xs/interfaces/ID3D12Device11/methods/id3d12device11_reportgpuhaltx)

[EnableLiveDebuggingX](/zh-TW/reference/graphics/d3d12_xs/interfaces/ID3D12Device11/methods/id3d12device11_enablelivedebuggingx)

[PIX 中的隨選即時偵錯](https://learn.microsoft.com/en-us/gaming/gdk/_content/gc/tools-console/xbox-tools-and-apis/pix/pix-on-demand-live-debugging)

[PIX 中的著色器例外狀況即時偵錯](https://learn.microsoft.com/en-us/gaming/gdk/_content/gc/tools-console/xbox-tools-and-apis/pix/pix-shader-exceptions-live-debugging)


## Related topics

- [NDA 토픽 디렉터리 - Microsoft Learn 라이브 링크](/ko/nda/nda-topic-directory.md)
- [Répertoire des rubriques NDA : liens actifs vers Microsoft Learn](/fr-CA/nda/nda-topic-directory.md)
- [Diretório de tópicos NDA: links ativos do Microsoft Learn](/pt-BR/nda/nda-topic-directory.md)
- [Directorio de temas NDA: enlaces activos a Microsoft Learn](/es/nda/nda-topic-directory.md)
- [NDA トピック ディレクトリ - Microsoft Learn 公開版へのリンク](/ja-jp/nda/nda-topic-directory.md)