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

# D3D12_TEXTURE_LAYOUT (XBOX One 系列)

> 指定紋理配置的選項。在 XBOX 上，此列舉包含 D3D12XBOX_ 擴充成員。

指定紋理配置的選項。在 XBOX 上，此列舉包含 D3D12XBOX\_ 擴充成員。

## 語法

```cpp theme={null}
typedef enum D3D12_TEXTURE_LAYOUT
{  
    D3D12_TEXTURE_LAYOUT_UNKNOWN = 0,  
    D3D12_TEXTURE_LAYOUT_ROW_MAJOR = 1,  
    D3D12_TEXTURE_LAYOUT_64KB_UNDEFINED_SWIZZLE = 2,  
    D3D12_TEXTURE_LAYOUT_64KB_STANDARD_SWIZZLE = 3,  
    D3D12XBOX_TEXTURE_LAYOUT_TILE_MODE_COMP_DEPTH_0 = 0x100,  
    D3D12XBOX_TEXTURE_LAYOUT_TILE_MODE_COMP_DEPTH_1 = 0x101,  
    D3D12XBOX_TEXTURE_LAYOUT_TILE_MODE_COMP_DEPTH_2 = 0x102,  
    D3D12XBOX_TEXTURE_LAYOUT_TILE_MODE_COMP_DEPTH_3 = 0x103,  
    D3D12XBOX_TEXTURE_LAYOUT_TILE_MODE_COMP_DEPTH_4 = 0x104,  
    D3D12XBOX_TEXTURE_LAYOUT_TILE_MODE_UNC_DEPTH_5 = 0x105,  
    D3D12XBOX_TEXTURE_LAYOUT_TILE_MODE_UNC_DEPTH_6 = 0x106,  
    D3D12XBOX_TEXTURE_LAYOUT_TILE_MODE_UNC_DEPTH_7 = 0x107,  
    D3D12XBOX_TEXTURE_LAYOUT_TILE_MODE_LINEAR = 0x108,  
    D3D12XBOX_TEXTURE_LAYOUT_TILE_MODE_1D_DISPLAY = 0x109,  
    D3D12XBOX_TEXTURE_LAYOUT_TILE_MODE_2D_DISPLAY = 0x10A,  
    D3D12XBOX_TEXTURE_LAYOUT_TILE_MODE_TILED_DISPLAY = 0x10B,  
    D3D12XBOX_TEXTURE_LAYOUT_TILE_MODE_TILED_2D_DISPLAY = 0x10C,  
    D3D12XBOX_TEXTURE_LAYOUT_TILE_MODE_1D_THIN = 0x10D,  
    D3D12XBOX_TEXTURE_LAYOUT_TILE_MODE_2D_THIN = 0x10E,  
    D3D12XBOX_TEXTURE_LAYOUT_TILE_MODE_3D_THIN = 0x10F,  
    D3D12XBOX_TEXTURE_LAYOUT_TILE_MODE_TILED_1D_THIN = 0x110,  
    D3D12XBOX_TEXTURE_LAYOUT_TILE_MODE_TILED_2D_THIN = 0x111,  
    D3D12XBOX_TEXTURE_LAYOUT_TILE_MODE_TILED_3D_THIN = 0x112,  
    D3D12XBOX_TEXTURE_LAYOUT_TILE_MODE_1D_THICK = 0x113,  
    D3D12XBOX_TEXTURE_LAYOUT_TILE_MODE_2D_THICK = 0x114,  
    D3D12XBOX_TEXTURE_LAYOUT_TILE_MODE_3D_THICK = 0x115,  
    D3D12XBOX_TEXTURE_LAYOUT_TILE_MODE_TILED_1D_THICK = 0x116,  
    D3D12XBOX_TEXTURE_LAYOUT_TILE_MODE_TILED_2D_THICK = 0x117,  
    D3D12XBOX_TEXTURE_LAYOUT_TILE_MODE_TILED_3D_THICK = 0x118,  
    D3D12XBOX_TEXTURE_LAYOUT_TILE_MODE_2D_XTHICK = 0x119,  
    D3D12XBOX_TEXTURE_LAYOUT_TILE_MODE_3D_XTHICK = 0x11A,  
    D3D12XBOX_TEXTURE_LAYOUT_TILE_MODE_LINEAR_GENERAL = 0x11F,  
    D3D12XBOX_TEXTURE_LAYOUT_TILE_MODE_MASK = 0x11F,  
} D3D12_TEXTURE_LAYOUT  
```

## 常數

| 常數 | 描述 |
| - | - |
| D3D12\_TEXTURE\_LAYOUT\_UNKNOWN | 紋理配置未知。 |
| D3D12\_TEXTURE\_LAYOUT\_ROW\_MAJOR | 紋理的資料以列優先順序 (也稱為 pitch-linear 順序) 儲存。 |
| D3D12\_TEXTURE\_LAYOUT\_64KB\_UNDEFINED\_SWIZZLE | 64KB 圖格內的配置及尾端 mip 封裝由驅動程式決定。沒有標準化的 swizzle 模式。 |
| D3D12\_TEXTURE\_LAYOUT\_64KB\_STANDARD\_SWIZZLE | 預設紋理使用標準化的 swizzle 模式。 |
| D3D12XBOX\_TEXTURE\_LAYOUT\_TILE\_MODE\_COMP\_DEPTH\_0 | 圖格模式為 COMP\_DEPTH\_0。壓縮深度是操作深度/樣板硬體的一般模式。COMP\_DEPTH 有多種變體，用於處理深度/樣板單元如何以 MSAA 處理樣板緩衝區。 |
| D3D12XBOX\_TEXTURE\_LAYOUT\_TILE\_MODE\_COMP\_DEPTH\_1 | 圖格模式為 COMP\_DEPTH\_1。 |
| D3D12XBOX\_TEXTURE\_LAYOUT\_TILE\_MODE\_COMP\_DEPTH\_2 | 圖格模式為 COMP\_DEPTH\_2。 |
| D3D12XBOX\_TEXTURE\_LAYOUT\_TILE\_MODE\_COMP\_DEPTH\_3 | 圖格模式為 COMP\_DEPTH\_3。 |
| D3D12XBOX\_TEXTURE\_LAYOUT\_TILE\_MODE\_COMP\_DEPTH\_4 | 圖格模式為 COMP\_DEPTH\_4。 |
| D3D12XBOX\_TEXTURE\_LAYOUT\_TILE\_MODE\_UNC\_DEPTH\_5 | 圖格模式為 UNC\_DEPTH\_5。驅動程式目前不使用未壓縮深度。UNC\_DEPTH 有多種變體，用於處理深度/樣板單元如何以 MSAA 處理樣板緩衝區。 |
| D3D12XBOX\_TEXTURE\_LAYOUT\_TILE\_MODE\_UNC\_DEPTH\_6 | 圖格模式為 UNC\_DEPTH\_6。 |
| D3D12XBOX\_TEXTURE\_LAYOUT\_TILE\_MODE\_UNC\_DEPTH\_7 | 圖格模式為 UNC\_DEPTH\_7。 |
| D3D12XBOX\_TEXTURE\_LAYOUT\_TILE\_MODE\_LINEAR | 圖格模式為 LINEAR。沒有微圖格或巨集圖格。 |
| D3D12XBOX\_TEXTURE\_LAYOUT\_TILE\_MODE\_1D\_DISPLAY | 圖格模式為 1D\_DISPLAY。顯示微圖格是 8x8x1 微圖格，其模式已針對顯示掃描輸出最佳化。 |
| D3D12XBOX\_TEXTURE\_LAYOUT\_TILE\_MODE\_2D\_DISPLAY | 圖格模式為 2D\_DISPLAY。 |
| D3D12XBOX\_TEXTURE\_LAYOUT\_TILE\_MODE\_TILED\_DISPLAY | 圖格模式為 TILED\_DISPLAY。搭配 D3D 並排資源使用。 |
| D3D12XBOX\_TEXTURE\_LAYOUT\_TILE\_MODE\_TILED\_2D\_DISPLAY | 圖格模式為 TILED\_2D\_DISPLAY。搭配 D3D 並排資源使用。2D 用於微圖格和巨集圖格。 |
| D3D12XBOX\_TEXTURE\_LAYOUT\_TILE\_MODE\_1D\_THIN | 圖格模式為 1D\_THIN。THIN 表示使用預設的微圖格模式：8x8x1 微圖格。 |
| D3D12XBOX\_TEXTURE\_LAYOUT\_TILE\_MODE\_2D\_THIN | 圖格模式為 2D\_THIN。 |
| D3D12XBOX\_TEXTURE\_LAYOUT\_TILE\_MODE\_3D\_THIN | 圖格模式為 3D\_THIN。 |
| D3D12XBOX\_TEXTURE\_LAYOUT\_TILE\_MODE\_TILED\_1D\_THIN | 圖格模式為 TILED\_1D\_THIN。搭配 D3D 並排資源使用。1D 僅用於微圖格。 |
| D3D12XBOX\_TEXTURE\_LAYOUT\_TILE\_MODE\_TILED\_2D\_THIN | 圖格模式為 TILED\_2D\_THIN。搭配 D3D 並排資源使用。2D 用於微圖格和巨集圖格。 |
| D3D12XBOX\_TEXTURE\_LAYOUT\_TILE\_MODE\_TILED\_3D\_THIN | 圖格模式為 TILED\_3D\_THIN。搭配 D3D 並排資源使用。3D 是兩層巨集圖格加上微圖格。 |
| D3D12XBOX\_TEXTURE\_LAYOUT\_TILE\_MODE\_1D\_THICK | 圖格模式為 1D\_THICK。THICK 和 XTHICK 是特殊的微圖格模式，設計用於陣列和體積紋理，驅動程式目前不使用。THICK 是 8x8x4 微圖格模式，與轉譯目標或深度樣板的使用不相容。XTHICK 是 8x8x8 微圖格模式，與轉譯目標或深度樣板的使用不相容。 |
| D3D12XBOX\_TEXTURE\_LAYOUT\_TILE\_MODE\_2D\_THICK | 圖格模式為 2D\_THICK。THICK 和 XTHICK 是特殊的微圖格模式，設計用於陣列和體積紋理，驅動程式目前不使用。 |
| D3D12XBOX\_TEXTURE\_LAYOUT\_TILE\_MODE\_3D\_THICK | 圖格模式為 3D\_THICK。THICK 和 XTHICK 是特殊的微圖格模式，設計用於陣列和體積紋理，驅動程式目前不使用。 |
| D3D12XBOX\_TEXTURE\_LAYOUT\_TILE\_MODE\_TILED\_1D\_THICK | 圖格模式為 TILED\_1D\_THICK，設計用於 D3D 並排資源。1D 僅用於微圖格。THICK 和 XTHICK 是特殊的微圖格模式，設計用於陣列和體積紋理，驅動程式目前不使用。 |
| D3D12XBOX\_TEXTURE\_LAYOUT\_TILE\_MODE\_TILED\_2D\_THICK | 圖格模式為 TILED\_2D\_THICK。搭配 D3D 並排資源使用。2D 用於微圖格和巨集圖格。THICK 和 XTHICK 是特殊的微圖格模式，設計用於陣列和體積紋理，驅動程式目前不使用。 |
| D3D12XBOX\_TEXTURE\_LAYOUT\_TILE\_MODE\_TILED\_3D\_THICK | 圖格模式為 TILED\_3D\_THICK。搭配 D3D 並排資源使用。3D 是兩層巨集圖格加上微圖格。THICK 和 XTHICK 是特殊的微圖格模式，設計用於陣列和體積紋理，驅動程式目前不使用。 |
| D3D12XBOX\_TEXTURE\_LAYOUT\_TILE\_MODE\_2D\_XTHICK | 圖格模式為 2D\_XTHICK。THICK 和 XTHICK 是特殊的微圖格模式，設計用於陣列和體積紋理，驅動程式目前不使用。 |
| D3D12XBOX\_TEXTURE\_LAYOUT\_TILE\_MODE\_3D\_XTHICK | 圖格模式為 3D\_XTHICK。THICK 和 XTHICK 是特殊的微圖格模式，設計用於陣列和體積紋理，驅動程式目前不使用。 |
| D3D12XBOX\_TEXTURE\_LAYOUT\_TILE\_MODE\_LINEAR\_GENERAL | 圖格模式為 LINEAR\_GENERAL。沒有微圖格或巨集圖格。D3D12XBOX\_TEXTURE\_LAYOUT\_TILE\_MODE\_LINEAR\_GENERAL 與 mipmap 不相容；建議改用 D3D12XBOX\_TEXTURE\_LAYOUT\_TILE\_MODE\_LINEAR。 |
| D3D12XBOX\_TEXTURE\_LAYOUT\_TILE\_MODE\_MASK | 位元遮罩，對應用於定義 XBOX 自訂紋理配置 (XBOX 圖格模式) 的位元。 |

## 備註

[D3D12\_RESOURCE\_DESC](https://learn.microsoft.com/en-us/windows/desktop/api/d3d12/ns-d3d12-d3d12_resource_desc) 結構使用此列舉。

適用於 XBOX One 的 Microsoft Game Development Kit (GDK) 定義了此列舉中的擴充成員，從 **D3D12XBOX\_TEXTURE\_LAYOUT\_TILE\_MODE\_COMP\_DEPTH\_0** 開始。如需此列舉非 XBOX 特定版本以及 swizzle 模式的相關資訊，請參閱 [D3D12\_TEXTURE\_LAYOUT](https://learn.microsoft.com/en-us/windows/desktop/api/d3d12/ne-d3d12-d3d12_texture_layout)。

## 需求

**標頭：** 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)
- [D3D12_TEXTURE_BARRIER (XBOX Series 主機)](/zh-TW/reference/graphics/d3d12/structs/d3d12_texture_barrier_public.md)
- [D3D12_RESOURCE_DESC1](/zh-TW/reference/graphics/d3d12/structs/d3d12_resource_desc1_public.md)
- [D3D12_TEXTURE_COPY_LOCATION](/zh-TW/reference/graphics/d3d12/structs/d3d12_texture_copy_location_public.md)
- [D3D12_TEXTURE_COPY_TYPE](/zh-TW/reference/graphics/d3d12/enums/d3d12_texture_copy_type_public.md)
