> ## 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_TEXTURE3D_DESC (XBOX One 系列)

> XG_TEXTURE3D_DESC (XBOX Series 主機)：為 XG 紋理配置 API 描述 3D 紋理。適用於 XBOX 遊戲開發的 Direct3D 12 圖形 API 參考。

為 XG 紋理配置 API 描述 3D 紋理。

<a id="syntaxSection" />

## 語法

```cpp theme={null}
typedef struct XG_TEXTURE3D_DESC {  
    UINT Width;
    UINT Height;
    UINT Depth;
    UINT MipLevels;
    XG_FORMAT Format;
    XG_USAGE Usage;
    UINT BindFlags;
    UINT CPUAccessFlags;
    UINT MiscFlags;
    UINT ESRAMOffsetBytes;
    UINT ESRAMUsageBytes;
    XG_TILE_MODE TileMode;
    UINT Pitch;
} XG_TEXTURE3D_DESC  
```

<a id="membersSection" />

### 成員

*Width*\
類型：UINT

紋理寬度 (以紋素為單位)。

*Height*\
類型：UINT

紋理高度 (以紋素為單位)。

*Depth*\
類型：UINT

紋理深度 (以紋素為單位)。

*MipLevels*\
類型：UINT

紋理中 mipmap 層級的最大數目。

*Format*\
類型：[XG\_FORMAT](/zh-TW/reference/graphics/xg__NR/enums/xg_format)

資源資料格式，以 [XG\_FORMAT](/zh-TW/reference/graphics/xg__NR/enums/xg_format) 列舉常數表示。

*Usage*\
類型：[XG\_USAGE](/zh-TW/reference/graphics/xg__NR/enums/xg_usage)

用途，以 [XG\_USAGE](/zh-TW/reference/graphics/xg__NR/enums/xg_usage) 列舉常數表示。

*BindFlags*\
類型：UINT

指出緩衝區如何繫結至管線的旗標，以 [XG\_BIND\_FLAG](/zh-TW/reference/graphics/xg__NR/enums/xg_bind_flag) 列舉常數的位元 OR 組合表示。

*CPUAccessFlags*\
類型：UINT

CPU 存取旗標，以 [XG\_CPU\_ACCESS\_FLAG](/zh-TW/reference/graphics/xg__NR/enums/xg_cpu_access_flag) 列舉常數的位元 OR 組合表示；如果不需要 CPU 存取，則為 0。

*MiscFlags*\
類型：UINT

其他旗標，以 [XG\_RESOURCE\_MISC\_FLAG](/zh-TW/reference/graphics/xg__NR/enums/xg_resource_misc_flag) 列舉常數的位元 OR 組合表示；如果未使用，則為 0。

*ESRAMOffsetBytes*\
類型：UINT

保留供內部使用。

*ESRAMUsageBytes*\
類型：UINT

保留供內部使用。

*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) 列舉常數表示。

*Pitch*\
類型：UINT

紋理間距。

<a id="remarksSection" />

## 備註

此結構為 XBOX Graphics (XG) 程式庫描述 3D 紋理。下列 XG 程式庫函式會使用 `XG_TEXTURE3D_DESC`：

* [XGComputeTexture3DLayout](/zh-TW/reference/graphics/xg__NR/functions/xgcomputetexture3dlayout)
* [XGCreateTexture3DComputer](/zh-TW/reference/graphics/xg__NR/functions/xgcreatetexture3dcomputer)

如需 XG 程式庫的詳細資訊，請參閱 [XBOX One 的原生資源管理](https://learn.microsoft.com/en-us/gaming/gdk/_content/gc/graphics/directx/native-resource-management)。

<a id="requirementsSection" />

## 需求

**標頭：** xg.h

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

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

<a id="seealsoSection" />

## 另請參閱

[XG 參考](/zh-TW/reference/graphics/xg__NR/xg_members)


## Related topics

- [NDA 主題目錄 - Microsoft Learn 線上連結](/zh-TW/nda/nda-topic-directory.md)
- [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)