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

> 描述單一資源的完整硬體配置。

描述單一資源的完整硬體配置。

<a id="syntaxSection" />

## 語法

```cpp theme={null}
typedef struct XG_RESOURCE_LAYOUT {  
    UINT64 SizeBytes;
    UINT64 BaseAlignmentBytes;
    UINT32 MipLevels;
    UINT32 Planes;
    XG_PLANE_LAYOUT Plane[4];
    XG_RESOURCE_DIMENSION Dimension;
} XG_RESOURCE_LAYOUT  
```

<a id="membersSection" />

### 成員

*SizeBytes*\
類型：UINT64

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

*BaseAlignmentBytes*\
類型：UINT64

資源的基底對齊 (以位元組為單位)。

*MipLevels*\
類型：UINT32

資源中 mipmap 層級的最大數目。

*Planes*\
類型：UINT32

資源中平面的最大數目。

*Plane*\
類型：[XG\_PLANE\_LAYOUT](/zh-TW/reference/graphics/xg__NR/structs/xg_plane_layout)\[4]

資源的平面配置，以 [XG\_PLANE\_LAYOUT](/zh-TW/reference/graphics/xg__NR/structs/xg_plane_layout) 結構陣列的形式提供。

*Dimension*\
類型：[XG\_RESOURCE\_DIMENSION](/zh-TW/reference/graphics/xg__NR/enums/xg_resource_dimension)

資源的維度，以 [XG\_RESOURCE\_DIMENSION](/zh-TW/reference/graphics/xg__NR/enums/xg_resource_dimension) 列舉常數表示。

<a id="remarksSection" />

## 備註

此結構描述 XBOX Graphics (XG) 程式庫中單一資源的完整硬體配置。某些資源組態最多可包含四 (4) 個平面，每個平面代表單一 mip 鏈結。

下列 XG 程式庫函式與方法會使用 `XG_RESOURCE_DESC`：

* [XGComputeBufferLayout](/zh-TW/reference/graphics/xg__NR/functions/xgcomputebufferlayout)
* [XGComputeTexture1DLayout](/zh-TW/reference/graphics/xg__NR/functions/xgcomputetexture1dlayout)
* [XGComputeTexture2DLayout](/zh-TW/reference/graphics/xg__NR/functions/xgcomputetexture2dlayout)
* [XGComputeTexture3DLayout](/zh-TW/reference/graphics/xg__NR/functions/xgcomputetexture3dlayout)
* [XGTextureAddressComputer::GetResourceLayout](/zh-TW/reference/graphics/xg__NR/interfaces/XGTextureAddressComputer/methods/xgtextureaddresscomputer_getresourcelayout)

如需 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)
- [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)