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

# XG_MIPLEVEL_LAYOUT (XBOX One 系列)

> XG_MIPLEVEL_LAYOUT (XBOX Series 主機)：描述紋理硬體配置中的單一 mip 層級。適用於 XBOX 的 Direct3D 12 圖形參考。

描述紋理硬體配置中的單一 mip 層級。

<a id="syntaxSection" />

## 語法

```cpp theme={null}
typedef struct XG_MIPLEVEL_LAYOUT {  
    UINT64 SizeBytes;
    UINT64 OffsetBytes;
    UINT64 Slice2DSizeBytes;
    UINT32 PitchPixels;
    UINT32 PitchBytes;
    UINT32 AlignmentBytes;
    UINT32 PaddedWidthElements;
    UINT32 PaddedHeightElements;
    UINT32 PaddedDepthOrArraySize;
    UINT32 WidthElements;
    UINT32 HeightElements;
    UINT32 DepthOrArraySize;
    UINT32 SampleCount;
    XG_TILE_MODE TileMode;
    UINT64 BankRotationAddressBitMask;  
    UINT64 BankRotationBytesPerSlice;  
    UINT32 SliceDepthElements;  
} XG_MIPLEVEL_LAYOUT  
```

<a id="ID4EU" />

### 成員

*SizeBytes*\
類型：UINT64

大小 (以位元組為單位)。

*OffsetBytes*\
類型：UINT64

位移 (以位元組為單位)。

*Slice2DSizeBytes*\
類型：UINT64

2D 切片大小 (以位元組為單位)。

*PitchPixels*\
類型：UINT32

間距像素數目。

*PitchBytes*\
類型：UINT32

間距 (以位元組為單位)。

*AlignmentBytes*\
類型：UINT32

對齊 (以位元組為單位)。

*PaddedWidthElements*\
類型：UINT32

填補後的寬度元素數目。

*PaddedHeightElements*\
類型：UINT32

填補後的高度元素數目。

*PaddedDepthOrArraySize*\
類型：UINT32

填補後的深度大小或陣列大小。

*WidthElements*\
類型：UINT32

寬度元素數目。

*HeightElements*\
類型：UINT32

高度元素數目。

*DepthOrArraySize*\
類型：UINT32

深度或陣列大小。

*SampleCount*\
類型：UINT32

取樣計數。

*TileMode*\
類型：[XG\_TILE\_MODE](/zh-TW/reference/graphics/xg__NR/enums/xg_tile_mode)

並排模式，以指向 [XG\_TILE\_MODE](/zh-TW/reference/graphics/xg__NR/enums/xg_tile_mode) 列舉的指標形式提供。

*BankRotationAddressBitMask*\
類型：UINT64

對應於可對紋理基底位址套用記憶庫輪替之位置的位元遮罩。如果不支援記憶庫輪替，此值會是 0。

*BankRotationBytesPerSlice*\
類型：UINT64

當記憶庫輪替的陣列紋理資源繫結為轉譯目標時，套用至每個切片基底位址的記憶庫輪替位元組數。

*SliceDepthElements*\
類型：UINT32

對於體積紋理和厚並排陣列紋理，這是切片的深度 (以元素為單位)。體積紋理的 mip 層級可能由多個體積切片組成。

<a id="remarks" />

## 備註

對於陣列或體積紋理，每個 mip 層級都由數個連續的切片組成。\
[XG\_PLANE\_LAYOUT](/zh-TW/reference/graphics/xg__NR/structs/xg_plane_layout) 結構會使用此結構。

<a id="requirements" />

## 需求

**標頭：** xg.h

**程式庫：** xg\_x.lib

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

## 另請參閱

[xg](/zh-TW/reference/graphics/xg__NR/xg_members)


## Related topics

- [NDA 主題目錄 - Microsoft Learn 線上連結](/zh-TW/nda/nda-topic-directory.md)
- [XBOX GDK 主機開發的 NDA 主題索引](/zh-TW/nda/nda-overview.md)
- [GameInputKeyboardLayoutCallback](/zh-TW/reference/input/gameinput/functions/gameinputkeyboardlayoutcallback.md)
- [D3D12_INPUT_LAYOUT_DESC](/zh-TW/reference/graphics/d3d12/structs/d3d12_input_layout_desc_public.md)
- [XGameStreamingShowTouchControlLayout](/zh-TW/reference/system/xgamestreaming/functions/xgamestreamingshowtouchcontrollayout.md)