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

# CopyTileMappings

> 將對應從來源保留資源複製到目的地保留資源。

將對應從來源保留資源複製到目的地保留資源。

## 語法

```cpp theme={null}
void CopyTileMappings(
    ID3D12Resource  pDstResource,
    const D3D12_TILED_RESOURCE_COORDINATE  pDstRegionStartCoordinate,
    ID3D12Resource  pSrcResource,
    const D3D12_TILED_RESOURCE_COORDINATE  pSrcRegionStartCoordinate,
    const D3D12_TILE_REGION_SIZE  pRegionSize,
    D3D12_TILE_MAPPING_FLAGS Flags
)
```

### 參數

*pDstResource \[in]*\
類型：ID3D12Resource \*

指向目的地保留資源的指標。

*pDstRegionStartCoordinate \[in]*\
類型：const D3D12\_TILED\_RESOURCE\_COORDINATE \*

指向
[D3D12\_TILED\_RESOURCE\_COORDINATE](/zh-TW/reference/graphics/d3d12/structs/d3d12_tiled_resource_coordinate_public) 結構的指標，此結構描述目的地保留資源的起始座標。

*pSrcResource \[in]*\
類型：ID3D12Resource \*

指向來源保留資源的指標。

*pSrcRegionStartCoordinate \[in]*\
類型：const D3D12\_TILED\_RESOURCE\_COORDINATE \*

指向 [D3D12\_TILED\_RESOURCE\_COORDINATE](/zh-TW/reference/graphics/d3d12/structs/d3d12_tiled_resource_coordinate_public) 結構的指標，此結構描述來源保留資源的起始座標。

*pRegionSize \[in]*\
類型：const D3D12\_TILE\_REGION\_SIZE \*

指向 [D3D12\_TILE\_REGION\_SIZE](/zh-TW/reference/graphics/d3d12/structs/d3d12_tile_region_size_public) 結構的指標，此結構描述保留區域的大小。

*Flags*\
類型：D3D12\_TILE\_MAPPING\_FLAGS

[D3D12\_TILE\_MAPPING\_FLAGS](/zh-TW/reference/graphics/d3d12/enums/d3d12_tile_mapping_flags_public) 的其中一個成員。

### 傳回值

類型：void

無。

## 備註

使用 **CopyTileMappings** 將圖格對應從一個保留資源複製到另一個保留資源，以複製資源對應，或在使用 [UpdateTileMappings](/zh-TW/reference/graphics/d3d12/interfaces/id3d12commandqueue/methods/id3d12commandqueue_updatetilemappings_public) 修改新對應之前先將其初始化。

**CopyTileMappings** 有助於執行在保留資源內部及之間移動對應等工作，例如捲動圖格。
來源和目的地區域可以重疊；在此情況下，複製的結果就如同先將來源儲存到暫存位置，
再從該處寫入目的地。

目的地和來源區域都必須完全容納在各自的資源中，否則行為未定義，且偵錯層會發出錯誤。

## 需求

**標頭：** d3d12\_xs.h 或 d3d12\_x.h\
**程式庫：** d3d12\_xs.lib 或 d3d12\_x.lib\
**支援的平台**：XBOX Series 主機和 XBOX One 系列主機

## 另請參閱

[ID3D12CommandQueue](/zh-TW/reference/graphics/d3d12_xs/interfaces/ID3D12CommandQueue/id3d12commandqueue_xs)

[UpdateTileMappings](/zh-TW/reference/graphics/d3d12/interfaces/id3d12commandqueue/methods/id3d12commandqueue_updatetilemappings_public)

[磁碟區並排資源](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/volume-tiled-resources)


## Related topics

- [D3D12_TILE_MAPPING_FLAGS](/zh-TW/reference/graphics/d3d12/enums/d3d12_tile_mapping_flags_public.md)
- [D3D12_TILE_REGION_SIZE](/zh-TW/reference/graphics/d3d12/structs/d3d12_tile_region_size_public.md)
- [D3D12_TILED_RESOURCE_COORDINATE](/zh-TW/reference/graphics/d3d12/structs/d3d12_tiled_resource_coordinate_public.md)
- [CreateReservedResource](/zh-TW/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_createreservedresource_public.md)
- [CreateReservedResource1 (XBOX Series 主機)](/zh-TW/reference/graphics/d3d12/interfaces/id3d12device4/methods/id3d12device4_createreservedresource1_public.md)