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

# D3D12XBOX_DEBUG_FLAGS (XBOX One 系列)

> 指定用於在 XBOX One 上執行偵錯的旗標。

指定用於在 XBOX One 上執行偵錯的旗標。

## 語法

```cpp theme={null}
typedef enum D3D12XBOX_DEBUG_FLAGS  : UINT  
{  
    D3D12XBOX_DEBUG_FLAG_NONE = 0x00000000,  
    D3D12XBOX_DEBUG_FLAG_API_ERROR_DISABLE_BREAKS = 0x00000001,  
    D3D12XBOX_DEBUG_FLAG_DISABLE_BARRIER_VALIDATION = 0x00000200,  
    D3D12XBOX_DEBUG_FLAG_ENABLE_TRANSITION_BARRIER_LOGGING = 0x00000400,  
    D3D12XBOX_DEBUG_FLAG_ENABLE_INVALID_ROOT_PARAMETER_VALIDATION = 0x00000800,  
    D3D12XBOX_DEBUG_FLAG_ENABLE_NULL_DESCRIPTOR_VALIDATION = 0x00001000,  
    D3D12XBOX_DEBUG_FLAG_ENABLE_NULL_VERTEX_BUFFER_VIEW_VALIDATION = 0x00002000,  
    D3D12XBOX_DEBUG_FLAG_ENABLE_OUT_OF_ORDER_CMD_LIST_VALIDATION = 0x00004000,  
    D3D12XBOX_DEBUG_FLAG_DISABLE_COMMON_STATE_PROMOTION_AND_DECAY = 0x00000000,  
} D3D12XBOX_DEBUG_FLAGS  
```

## 常數

| 常數 | 描述 |
| - | - |
| D3D12XBOX\_DEBUG\_FLAG\_NONE | 未設定任何旗標。 |
| D3D12XBOX\_DEBUG\_FLAG\_API\_ERROR\_DISABLE\_BREAKS | 停用偵錯中斷。根據預設，每個驗證錯誤都會導致驅動程式中斷進入偵錯工具，並顯示錯誤的呼叫堆疊。此選項會停用這些偵錯中斷。 |
| D3D12XBOX\_DEBUG\_FLAG\_DISABLE\_BARRIER\_VALIDATION | 如果資源轉換屏障的驗證因在 **ExecuteCommandLists** 時執行的驗證工作量而具有相對較高的 CPU 成本，則停用該驗證。 |
| D3D12XBOX\_DEBUG\_FLAG\_ENABLE\_TRANSITION\_BARRIER\_LOGGING | 在資源轉換屏障的驗證程式碼處理每個資源轉換屏障時，啟用一行偵錯列印文字。此資訊記錄有助於追蹤遺漏或不正確的資源轉換屏障。 |
| D3D12XBOX\_DEBUG\_FLAG\_ENABLE\_INVALID\_ROOT\_PARAMETER\_VALIDATION | 在資源轉換屏障驗證期間啟用額外檢查。當繪製或分派使用的根參數在根簽章前次變更之後尚未設定為有效值時，會引發錯誤。由於此情況通常無害，因此預設會停用此驗證。 |
| D3D12XBOX\_DEBUG\_FLAG\_ENABLE\_NULL\_DESCRIPTOR\_VALIDATION | 在資源轉換屏障驗證期間啟用額外檢查。當繪製或分派參考了 null 描述元時，會引發錯誤。此情況可能無害或屬於預期行為，但若非預期，也可能是正確性錯誤。 |
| D3D12XBOX\_DEBUG\_FLAG\_ENABLE\_NULL\_VERTEX\_BUFFER\_VIEW\_VALIDATION | 在資源轉換屏障驗證期間啟用額外檢查。當繪製參考了 null 頂點緩衝區檢視時，會引發錯誤。此情況可能無害或屬於預期行為，但若非預期，也可能是正確性錯誤。 |
| D3D12XBOX\_DEBUG\_FLAG\_ENABLE\_OUT\_OF\_ORDER\_CMD\_LIST\_VALIDATION | 啟用非循序命令清單驗證。 |
| D3D12XBOX\_DEBUG\_FLAG\_DISABLE\_COMMON\_STATE\_PROMOTION\_AND\_DECAY | 已淘汰。 |

## 備註

此列舉會傳入 [SetDebugFlagsX](/zh-TW/reference/graphics/d3d12_x/interfaces/id3d12device/methods/id3d12device_setdebugflagsx)，並由 [GetDebugFlagsX](/zh-TW/reference/graphics/d3d12_x/interfaces/id3d12device/methods/id3d12device_getdebugflagsx) 傳回。

列舉值 **D3D12XBOX\_DEBUG\_FLAG\_DISABLE\_COMMON\_STATE\_PROMOTION\_AND\_DECAY** 已淘汰，並定義為 0x00000000，以抵銷其對使用它的現有程式碼可能造成的任何影響。此值將在未來的版本中移除。

## 需求

**標頭：** d3d12\_x.h

**支援的平台：** XBOX One 系列

## 另請參閱

[d3d12\_x](/zh-TW/reference/graphics/d3d12_x/d3d12_x_members)


## Related topics

- [NDA 主題目錄 - Microsoft Learn 線上連結](/zh-TW/nda/nda-topic-directory.md)
- [NDA topic directory - live Microsoft Learn links](/nda/nda-topic-directory.md)
- [Diretório de tópicos NDA: links ativos do Microsoft Learn](/pt-BR/nda/nda-topic-directory.md)
- [Répertoire des rubriques NDA : liens actifs vers Microsoft Learn](/fr-CA/nda/nda-topic-directory.md)
- [Directorio de temas NDA: enlaces activos a Microsoft Learn](/es/nda/nda-topic-directory.md)