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

# CopyRaytracingAccelerationStructure (XBOX Series 主機)

> 將來源加速結構複製到目的地記憶體，同時套用指定的轉換。

將來源加速結構複製到目的地記憶體，同時套用指定的轉換。

## 語法

```cpp theme={null}
void CopyRaytracingAccelerationStructure(
    D3D12_GPU_VIRTUAL_ADDRESS DestAccelerationStructureData,
    D3D12_GPU_VIRTUAL_ADDRESS SourceAccelerationStructureData,
    D3D12_RAYTRACING_ACCELERATION_STRUCTURE_COPY_MODE Mode
)
```

### 參數

*DestAccelerationStructureData \[in]*\
類型：D3D12\_GPU\_VIRTUAL\_ADDRESS

目的地記憶體。如果指定的 <i>Mode</i> 需要，可以事先呼叫 [EmitRaytracingAccelerationStructurePostbuildInfo](/zh-TW/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist4/methods/id3d12graphicscommandlist4_emitraytracingaccelerationstructurepostbuildinfo_public) 來得知所需的大小。

無論指定的 <i>Mode</i> 為何，目的地起始位址都必須對齊 256 個位元組，其定義為 [D3D12\_RAYTRACING\_ACCELERATION\_STRUCTURE\_BYTE\_ALIGNMENT](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/constants)。

目的地記憶體範圍不能與來源重疊，否則結果將是未定義的。

所指向的記憶體必須處於的資源狀態取決於 <i>Mode</i> 參數。如需詳細資訊，請參閱 [D3D12\_RAYTRACING\_ACCELERATION\_STRUCTURE\_COPY\_MODE](/zh-TW/reference/graphics/d3d12/enums/d3d12_raytracing_acceleration_structure_copy_mode_public)。

*SourceAccelerationStructureData \[in]*\
類型：D3D12\_GPU\_VIRTUAL\_ADDRESS

要根據指定的 <i>Mode</i> 複製/轉換之加速結構或其他類型資料的位址。資料會保持不變且可使用。此作業只會複製 <i>SourceAccelerationStructureData</i> 所指向的資料，而不會複製來源資料可能指向的任何其他資料 (例如加速結構)。例如，在頂層加速結構的情況下，此作業不會複製它所指向的任何底層加速結構。

無論指定的 <i>Mode</i> 為何，來源記憶體都必須對齊 256 個位元組，其定義為 [D3D12\_RAYTRACING\_ACCELERATION\_STRUCTURE\_BYTE\_ALIGNMENT](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/constants)。

所指向的記憶體必須處於的資源狀態取決於 <i>Mode</i> 參數。如需詳細資訊，請參閱 [D3D12\_RAYTRACING\_ACCELERATION\_STRUCTURE\_COPY\_MODE](/zh-TW/reference/graphics/d3d12/enums/d3d12_raytracing_acceleration_structure_copy_mode_public)。

*Mode \[in]*\
類型：D3D12\_RAYTRACING\_ACCELERATION\_STRUCTURE\_COPY\_MODE

要執行的複製作業類型。如需詳細資訊，請參閱 [D3D12\_RAYTRACING\_ACCELERATION\_STRUCTURE\_COPY\_MODE](/zh-TW/reference/graphics/d3d12/enums/d3d12_raytracing_acceleration_structure_copy_mode_public)。

### 傳回值

類型：void

無。

## 備註

由於光線追蹤加速結構可能包含內部指標，且具有與裝置相關的不透明配置，因此複製或以其他方式操作它們需要專用的 API，讓驅動程式能夠處理所要求的作業。

此方法可以從圖形或計算命令清單呼叫，但不能從套件組合呼叫。

## 需求

**標頭:** d3d12\_xs.h\
**程式庫:** d3d12\_xs.lib\
**支援的平台**: XBOX Series 主機

## 另請參閱

[ID3D12GraphicsCommandList4](/zh-TW/reference/graphics/d3d12_xs/interfaces/ID3D12GraphicsCommandList4/id3d12graphicscommandlist4)


## Related topics

- [BuildRaytracingAccelerationStructure (XBOX Series 主機)](/zh-TW/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist4/methods/id3d12graphicscommandlist4_buildraytracingaccelerationstructure_public.md)
- [D3D12_BUILD_RAYTRACING_ACCELERATION_STRUCTURE_TOOLS_VISUALIZATION_HEADER (XBOX Series 主機)](/zh-TW/reference/graphics/d3d12/structs/d3d12_build_raytracing_acceleration_structure_tools_visualization_header_public.md)
- [D3D12_RAYTRACING_ACCELERATION_STRUCTURE_POSTBUILD_INFO_SERIALIZATION_DESC (XBOX Series 主機)](/zh-TW/reference/graphics/d3d12/structs/d3d12_raytracing_acceleration_structure_postbuild_info_serialization_desc_public.md)
- [D3D12_RAYTRACING_ACCELERATION_STRUCTURE_POSTBUILD_INFO_CURRENT_SIZE_DESC (XBOX Series 主機)](/zh-TW/reference/graphics/d3d12/structs/d3d12_raytracing_acceleration_structure_postbuild_info_current_size_desc_public.md)
- [D3D12_RAYTRACING_ACCELERATION_STRUCTURE_POSTBUILD_INFO_COMPACTED_SIZE_DESC (XBOX Series 主機)](/zh-TW/reference/graphics/d3d12/structs/d3d12_raytracing_acceleration_structure_postbuild_info_compacted_size_desc_public.md)