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

> 描述具有 mipmap 之並排資源的圖格結構。

描述具有 mipmap 之並排資源的圖格結構。

<a id="syntaxSection" />

## 語法

```cpp theme={null}
typedef struct XG_PACKED_MIP_DESC {
    UINT8 NumStandardMips;
    UINT8 NumPackedMips;
    UINT32 NumTilesForPackedMips;
    UINT32 StartTileIndexInOverallResource;
} XG_PACKED_MIP_DESC  
```

<a id="membersSection" />

### 成員

*NumStandardMips*\
類型：UINT8

並排資源中的標準 mipmap 數目。

*NumPackedMips*\
類型：UINT8

並排資源中的封裝 mipmap 數目。

*NumTilesForPackedMips*\
類型：UINT32

並排資源中封裝 mipmap 的圖格數目。

*StartTileIndexInOverallResource*\
類型：UINT32

資源的第一個封裝圖格在整體圖格範圍中的起始位移。

<a id="remarksSection" />

## 備註

API 項目 [XGTextureAddressComputer::GetResourceTiling](/zh-TW/reference/graphics/xg__NR/interfaces/XGTextureAddressComputer/methods/xgtextureaddresscomputer_getresourcetiling) 會使用此結構，描述使用 [XG\_RESOURCE\_MISC\_FLAG](/zh-TW/reference/graphics/xg__NR/enums/xg_resource_misc_flag) 列舉中的 `XG_RESOURCE_MISC_TILED` 常數所建立之並排資源的圖格結構。

`NumStandardMips` 的值從細節最少的 mipmap (共用圖格或使用非標準圖格配置) 開始計算。如果資源中沒有這類封裝，此數字為 0。對於陣列表面，`NumStandardMips` 是針對給定陣列切片所封裝的 mipmap 數目，其中每個陣列切片都會重複相同的封裝。

如果整個資源都未封裝，`NumPackedMips` 和 `StartTileIndexInOverallResource` 的值都會設為 0。如果整個資源都已封裝，則只有 `StartTileIndexInOverallResource` 的值會設為 0。

否則，`NumPackedMips` 會設為表示該組封裝 mipmap 所需的圖格數目，而 `StartTileIndexInOverallResource` 會設為資源的第一個封裝圖格在該資源整體圖格範圍中的位移。對於陣列，`NumPackedMips` 只會設為每個陣列切片之子資源內的封裝 mipmap 計數，而 `StartTileIndexInOverallResource` 會設為包含第一個陣列切片之封裝 mipmap 的圖格位移。在陣列表面中，每個陣列切片的封裝 mipmap 都位於該陣列切片圖格起點之後的這個位移處。

<Note>
  給定陣列切片的整體圖格數目 (無論是否封裝) 就是資源的圖格總數除以資源的陣列大小，因此可輕鬆找出任何給定陣列切片的圖格範圍，而 `StartTileIndexInOverallResource` 會從中識別哪些圖格已封裝。
</Note>

<a id="requirementsSection" />

## 需求

**標頭：** xg.h

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

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

<a id="seealsoSection" />

## 另請參閱

[XBOX One 的原生資源管理](https://learn.microsoft.com/en-us/gaming/gdk/_content/gc/graphics/directx/native-resource-management)\
[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)
- [GetResourceTiling](/zh-TW/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_getresourcetiling_public.md)
- [D3D12_MIP_REGION](/zh-TW/reference/graphics/d3d12/structs/d3d12_mip_region_public.md)
- [D3D12_DESCRIPTOR_HEAP_DESC](/zh-TW/reference/graphics/d3d12/structs/d3d12_descriptor_heap_desc_public.md)