> ## 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 콘솔)](/ko/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist4/methods/id3d12graphicscommandlist4_buildraytracingaccelerationstructure_public.md)
- [D3D12_BUILD_RAYTRACING_ACCELERATION_STRUCTURE_TOOLS_VISUALIZATION_HEADER (XBOX Series 콘솔)](/ko/reference/graphics/d3d12/structs/d3d12_build_raytracing_acceleration_structure_tools_visualization_header_public.md)
- [D3D12_RAYTRACING_ACCELERATION_STRUCTURE_POSTBUILD_INFO_SERIALIZATION_DESC (XBOX Series 콘솔)](/ko/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 콘솔)](/ko/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 콘솔)](/ko/reference/graphics/d3d12/structs/d3d12_raytracing_acceleration_structure_postbuild_info_compacted_size_desc_public.md)