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

> Copia una estructura de aceleración de origen en la memoria de destino mientras aplica la transformación especificada.

Copia una estructura de aceleración de origen en la memoria de destino mientras aplica la transformación especificada.

## Sintaxis

```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

La memoria de destino. El tamaño requerido se puede detectar llamando previamente a [EmitRaytracingAccelerationStructurePostbuildInfo](/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist4/methods/id3d12graphicscommandlist4_emitraytracingaccelerationstructurepostbuildinfo_public), si es necesario para el <i>Mode</i> especificado.

La dirección inicial de destino debe estar alineada a 256 bytes, lo que se define como [D3D12\_RAYTRACING\_ACCELERATION\_STRUCTURE\_BYTE\_ALIGNMENT](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/constants), independientemente del <i>Mode</i> especificado.

El intervalo de memoria de destino no puede superponerse con el origen. De lo contrario, los resultados son indefinidos.

El estado de recurso en el que debe estar la memoria a la que se apunta depende del parámetro <i>Mode</i>. Para obtener más información, consulte [D3D12\_RAYTRACING\_ACCELERATION\_STRUCTURE\_COPY\_MODE](/reference/graphics/d3d12/enums/d3d12_raytracing_acceleration_structure_copy_mode_public).

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

La dirección de la estructura de aceleración u otro tipo de datos que se van a copiar o transformar en función del <i>Mode</i> especificado.  Los datos permanecen sin cambios y utilizables.  La operación solo copia los datos a los que apunta <i>SourceAccelerationStructureData</i> y no otros datos, como estructuras de aceleración, a los que puedan apuntar los datos de origen.  Por ejemplo, en el caso de una estructura de aceleración de nivel superior, las estructuras de aceleración de nivel inferior a las que apunta no se copian en la operación.

La memoria de origen debe estar alineada a 256 bytes, lo que se define como [D3D12\_RAYTRACING\_ACCELERATION\_STRUCTURE\_BYTE\_ALIGNMENT](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/constants), independientemente del <i>Mode</i> especificado.

El estado de recurso en el que debe estar la memoria a la que se apunta depende del parámetro <i>Mode</i>. Para obtener más información, consulte [D3D12\_RAYTRACING\_ACCELERATION\_STRUCTURE\_COPY\_MODE](/reference/graphics/d3d12/enums/d3d12_raytracing_acceleration_structure_copy_mode_public).

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

El tipo de operación de copia que se va a realizar. Para obtener más información, consulte [D3D12\_RAYTRACING\_ACCELERATION\_STRUCTURE\_COPY\_MODE](/reference/graphics/d3d12/enums/d3d12_raytracing_acceleration_structure_copy_mode_public).

### Valor devuelto

Tipo: void

Ninguno.

## Comentarios

Dado que las estructuras de aceleración de trazado de rayos pueden contener punteros internos y tener un diseño opaco dependiente del dispositivo, copiarlas o manipularlas de otro modo requiere una API dedicada para que los controladores puedan controlar la operación solicitada.

Este método se puede llamar desde listas de comandos de gráficos o de proceso, pero no desde agrupaciones.

## Requisitos

**Encabezado:** d3d12\_xs.h\
**Biblioteca:** d3d12\_xs.lib\
**Plataformas compatibles**: consolas XBOX Series

## Consulte también

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


## Related topics

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