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

> 描述 XG 資源。

描述 XG 資源。

<a id="syntaxSection" />

## 語法

```cpp theme={null}
typedef struct XG_RESOURCE_DESC {
    XG_RESOURCE_DIMENSION Dimension;
    UINT64 Alignment;
    UINT64 Width;
    UINT Height;
    UINT16 DepthOrArraySize;
    UINT16 MipLevels;
    XG_FORMAT Format;
    XG_SAMPLE_DESC SampleDesc;
    XG_TEXTURE_LAYOUT Layout;
    XG12_RESOURCE_MISC_FLAG MiscFlags;
} XG_RESOURCE_DESC  
```

<a id="ID4EI" />

### 成員

*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) 列舉常數表示。目前僅支援紋理維度。

*Alignment*\
類型：UINT64

資源的對齊 (以位元組為單位)。若要使用預設對齊，請指定零。

*Width*\
類型：UINT64

資源的寬度 (以紋素為單位)。

*Height*\
類型：UINT

資源的高度 (以紋素為單位)。

*DepthOrArraySize*\
類型：UINT16

對於體積紋理，這是資源的深度。對於陣列紋理，這是陣列切片的數目。

*MipLevels*\
類型：UINT16

資源中的 mip 層級數目。若要使用完整的 mip 鏈結，請指定零。

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

格式，以 [XG\_FORMAT](/zh-TW/reference/graphics/xg__NR/enums/xg_format) 列舉常數表示 (相當於 DXGI\_FORMAT 值)。

*SampleDesc*\
類型：[XG\_SAMPLE\_DESC](/zh-TW/reference/graphics/xg__NR/structs/xg_sample_desc)

取樣的描述，以 [XG\_SAMPLE\_DESC](/zh-TW/reference/graphics/xg__NR/structs/xg_sample_desc) 結構表示，相當於 [DXGI\_SAMPLE\_DESC](https://learn.microsoft.com/en-us/windows/desktop/api/dxgicommon/ns-dxgicommon-dxgi_sample_desc)。

*Layout*\
類型：[XG\_TEXTURE\_LAYOUT](/zh-TW/reference/graphics/xg__NR/enums/xg_texture_layout)

紋理並排模式，以 [XG\_TEXTURE\_LAYOUT](/zh-TW/reference/graphics/xg__NR/enums/xg_texture_layout) 列舉常數表示。若要選取預設的並排模式，請指定 XG\_TEXTURE\_LAYOUT\_UNKNOWN。

*MiscFlags*\
類型：[XG12\_RESOURCE\_MISC\_FLAG](/zh-TW/reference/graphics/xg__NR/enums/xg12_resource_misc_flag)

旗標，以 [XG12\_RESOURCE\_MISC\_FLAG](/zh-TW/reference/graphics/xg__NR/enums/xg12_resource_misc_flag) 列舉常數的位元 OR 組合表示，例如「無」、「允許轉譯目標」、「允許深度樣板」、「允許未排序存取」或「拒絕著色器資源」。XG12\_RESOURCE\_MISC\_FLAG 相當於 [D3D12\_RESOURCE\_FLAGS](/zh-TW/reference/graphics/d3d12_x/enums/d3d12_resource_flags)。

<a id="remarks" />

## 備註

API 項目 [XGCreateTextureComputer](/zh-TW/reference/graphics/xg__NR/functions/xgcreatetexturecomputer) 會使用此結構。

此結構與 [D3D12\_RESOURCE\_DESC](https://msdn.microsoft.com/library/dn903813\(v=vs.85\).aspx) 相同，可向 XG 描述任何維度的紋理。

請注意，XG\_RESOURCE\_DESC 是 [D3D12XBOX\_RESOURCE\_DESC](/zh-TW/reference/graphics/d3d12_x/structs/d3d12xbox_resource_desc) 的子集。
D3D12XBOX\_RESOURCE\_DESC 中不存在於 XG\_RESOURCE\_DESC 的成員 (具體而言就是 DCC 選項結構)，不會對資源描述所指定的計算記憶體配置產生任何影響。

<a id="requirements" />

## 需求

**標頭：** xg.h

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

## 另請參閱

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


## Related topics

- [NDA 主題目錄 - Microsoft Learn 線上連結](/zh-TW/nda/nda-topic-directory.md)
- [ID3D12Resource::GetDesc](/zh-TW/reference/graphics/d3d12/interfaces/id3d12resource/methods/id3d12resource_getdesc_public.md)
- [D3D12_PROTECTED_RESOURCE_SESSION_DESC](/zh-TW/reference/graphics/d3d12/structs/d3d12_protected_resource_session_desc_public.md)
- [D3D12_SHADER_RESOURCE_VIEW_DESC](/zh-TW/reference/graphics/d3d12/structs/d3d12_shader_resource_view_desc_public.md)
- [XBOX GDK 主機開發的 NDA 主題索引](/zh-TW/nda/nda-overview.md)