> ## 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](/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist4/methods/id3d12graphicscommandlist4_emitraytracingaccelerationstructurepostbuildinfo_public) を呼び出すことで判明します。

宛先の先頭アドレスは、指定した <i>Mode</i> にかかわらず、[D3D12\_RAYTRACING\_ACCELERATION\_STRUCTURE\_BYTE\_ALIGNMENT](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/constants) として定義される 256 バイトにアラインされている必要があります。

宛先のメモリ範囲はソースと重なってはいけません。重なっている場合、結果は未定義になります。

指されているメモリが取るべきリソース状態は、<i>Mode</i> パラメーターによって決まります。詳細については、[D3D12\_RAYTRACING\_ACCELERATION\_STRUCTURE\_COPY\_MODE](/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> にかかわらず、[D3D12\_RAYTRACING\_ACCELERATION\_STRUCTURE\_BYTE\_ALIGNMENT](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/constants) として定義される 256 バイトにアラインされている必要があります。

指されているメモリが取るべきリソース状態は、<i>Mode</i> パラメーターによって決まります。詳細については、[D3D12\_RAYTRACING\_ACCELERATION\_STRUCTURE\_COPY\_MODE](/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](/reference/graphics/d3d12/enums/d3d12_raytracing_acceleration_structure_copy_mode_public) を参照してください。

### 戻り値

型: void

なし。

## 解説

レイトレーシング アクセラレーション構造には内部ポインターが含まれることがあり、デバイス依存の不透明なレイアウトを持つ場合があるため、それらのコピーや操作にはドライバーが要求された操作を処理できるように専用の API が必要です。

このメソッドは、グラフィックスまたはコンピュートのコマンド リストから呼び出すことができますが、バンドルからは呼び出すことができません。

## 要件

**ヘッダー:** d3d12\_xs.h\
**ライブラリ:** d3d12\_xs.lib\
**サポートされているプラットフォーム**: XBOX Series 本体

## 関連項目

[ID3D12GraphicsCommandList4](/reference/graphics/d3d12_xs/interfaces/ID3D12GraphicsCommandList4/id3d12graphicscommandlist4)


## Related topics

- [BuildRaytracingAccelerationStructure (XBOX Series 本体)](/ja-jp/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist4/methods/id3d12graphicscommandlist4_buildraytracingaccelerationstructure_public.md)
- [D3D12_RAYTRACING_ACCELERATION_STRUCTURE_POSTBUILD_INFO_SERIALIZATION_DESC (XBOX Series 本体)](/ja-jp/reference/graphics/d3d12/structs/d3d12_raytracing_acceleration_structure_postbuild_info_serialization_desc_public.md)
- [D3D12_RAYTRACING_ACCELERATION_STRUCTURE_POSTBUILD_INFO_COMPACTED_SIZE_DESC (XBOX Series 本体)](/ja-jp/reference/graphics/d3d12/structs/d3d12_raytracing_acceleration_structure_postbuild_info_compacted_size_desc_public.md)
- [D3D12_RAYTRACING_ACCELERATION_STRUCTURE_POSTBUILD_INFO_CURRENT_SIZE_DESC (XBOX Series 本体)](/ja-jp/reference/graphics/d3d12/structs/d3d12_raytracing_acceleration_structure_postbuild_info_current_size_desc_public.md)
- [D3D12_RAYTRACING_ACCELERATION_STRUCTURE_POSTBUILD_INFO_TOOLS_VISUALIZATION_DESC (XBOX Series 本体)](/ja-jp/reference/graphics/d3d12/structs/d3d12_raytracing_acceleration_structure_postbuild_info_tools_visualization_desc_public.md)