> ## 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 (consoles XBOX Series)

> Copia uma estrutura de aceleração de origem para a memória de destino, aplicando a transformação especificada.

Copia uma estrutura de aceleração de origem para a memória de destino, aplicando a transformação especificada.

## Sintaxe

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

### Parâmetros

*DestAccelerationStructureData \[in]*\
Tipo: D3D12\_GPU\_VIRTUAL\_ADDRESS

A memória de destino. O tamanho necessário pode ser descoberto chamando [EmitRaytracingAccelerationStructurePostbuildInfo](/pt-BR/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist4/methods/id3d12graphicscommandlist4_emitraytracingaccelerationstructurepostbuildinfo_public) previamente, se necessário para o <i>Mode</i> especificado.

O endereço inicial de destino deve estar alinhado a 256 bytes, definido como [D3D12\_RAYTRACING\_ACCELERATION\_STRUCTURE\_BYTE\_ALIGNMENT](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/constants), independentemente do <i>Mode</i> especificado.

O intervalo de memória de destino não pode se sobrepor à origem. Caso contrário, os resultados serão indefinidos.

O estado de recurso em que a memória apontada deve estar depende do parâmetro <i>Mode</i>. Para obter mais informações, consulte [D3D12\_RAYTRACING\_ACCELERATION\_STRUCTURE\_COPY\_MODE](/pt-BR/reference/graphics/d3d12/enums/d3d12_raytracing_acceleration_structure_copy_mode_public).

*SourceAccelerationStructureData \[in]*\
Tipo: D3D12\_GPU\_VIRTUAL\_ADDRESS

O endereço da estrutura de aceleração ou de outro tipo de dados a ser copiado/transformado com base no <i>Mode</i> especificado. Os dados permanecem inalterados e utilizáveis. A operação copia apenas os dados apontados por <i>SourceAccelerationStructureData</i> e não quaisquer outros dados, como estruturas de aceleração, para os quais os dados de origem possam apontar. Por exemplo, no caso de uma estrutura de aceleração de nível superior, as estruturas de aceleração de nível inferior para as quais ela aponta não são copiadas na operação.

A memória de origem deve estar alinhada a 256 bytes, definido como [D3D12\_RAYTRACING\_ACCELERATION\_STRUCTURE\_BYTE\_ALIGNMENT](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/constants), independentemente do <i>Mode</i> especificado.

O estado de recurso em que a memória apontada deve estar depende do parâmetro <i>Mode</i>. Para obter mais informações, consulte [D3D12\_RAYTRACING\_ACCELERATION\_STRUCTURE\_COPY\_MODE](/pt-BR/reference/graphics/d3d12/enums/d3d12_raytracing_acceleration_structure_copy_mode_public).

*Mode \[in]*\
Tipo: D3D12\_RAYTRACING\_ACCELERATION\_STRUCTURE\_COPY\_MODE

O tipo de operação de cópia a ser executada. Para obter mais informações, consulte [D3D12\_RAYTRACING\_ACCELERATION\_STRUCTURE\_COPY\_MODE](/pt-BR/reference/graphics/d3d12/enums/d3d12_raytracing_acceleration_structure_copy_mode_public).

### Valor retornado

Tipo: void

Nenhum.

## Comentários

Como as estruturas de aceleração de raytracing podem conter ponteiros internos e ter um layout opaco dependente do dispositivo, copiá-las ou manipulá-las de outra forma exige uma API dedicada para que os drivers possam lidar com a operação solicitada.

Este método pode ser chamado a partir de listas de comandos de gráficos ou de computação, mas não a partir de pacotes.

## Requisitos

**Cabeçalho:** d3d12\_xs.h\
**Biblioteca:** d3d12\_xs.lib\
**Plataformas com suporte**: consoles XBOX Series

## Confira também

[ID3D12GraphicsCommandList4](/pt-BR/reference/graphics/d3d12_xs/interfaces/ID3D12GraphicsCommandList4/id3d12graphicscommandlist4)


## Related topics

- [BuildRaytracingAccelerationStructure (consoles XBOX Series)](/pt-BR/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist4/methods/id3d12graphicscommandlist4_buildraytracingaccelerationstructure_public.md)
- [D3D12_RAYTRACING_ACCELERATION_STRUCTURE_POSTBUILD_INFO_SERIALIZATION_DESC (consoles XBOX Series)](/pt-BR/reference/graphics/d3d12/structs/d3d12_raytracing_acceleration_structure_postbuild_info_serialization_desc_public.md)
- [D3D12_BUILD_RAYTRACING_ACCELERATION_STRUCTURE_TOOLS_VISUALIZATION_HEADER (consoles XBOX Series)](/pt-BR/reference/graphics/d3d12/structs/d3d12_build_raytracing_acceleration_structure_tools_visualization_header_public.md)
- [D3D12_RAYTRACING_ACCELERATION_STRUCTURE_POSTBUILD_INFO_CURRENT_SIZE_DESC (consoles XBOX Series)](/pt-BR/reference/graphics/d3d12/structs/d3d12_raytracing_acceleration_structure_postbuild_info_current_size_desc_public.md)
- [D3D12_RAYTRACING_ACCELERATION_STRUCTURE_POSTBUILD_INFO_COMPACTED_SIZE_DESC (consoles XBOX Series)](/pt-BR/reference/graphics/d3d12/structs/d3d12_raytracing_acceleration_structure_postbuild_info_compacted_size_desc_public.md)