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

# GetRaytracingAccelerationStructurePrebuildInfo

> Consulta o driver sobre os requisitos de recursos para criar uma estrutura de aceleração.

Consulta o driver sobre os requisitos de recursos para criar uma estrutura de aceleração.

## Sintaxe

```cpp theme={null}
void GetRaytracingAccelerationStructurePrebuildInfo(
    const D3D12_BUILD_RAYTRACING_ACCELERATION_STRUCTURE_INPUTS  pDesc,
    D3D12_RAYTRACING_ACCELERATION_STRUCTURE_PREBUILD_INFO  pInfo
)
```

### Parâmetros

*pDesc \[in]*\
Tipo: const D3D12\_BUILD\_RAYTRACING\_ACCELERATION\_STRUCTURE\_INPUTS \*

Descrição da criação da estrutura de aceleração. Esta estrutura é compartilhada com [BuildRaytracingAccelerationStructure](/pt-BR/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist4/methods/id3d12graphicscommandlist4_buildraytracingaccelerationstructure_public).  Para obter mais informações, consulte [D3D12\_BUILD\_RAYTRACING\_ACCELERATION\_STRUCTURE\_INPUTS](/pt-BR/reference/graphics/d3d12/structs/d3d12_build_raytracing_acceleration_structure_inputs_public).

A implementação pode examinar todos os parâmetros de CPU nesta struct e nas structs aninhadas.  Ela não pode inspecionar/desreferenciar nenhum endereço virtual de GPU, exceto para verificar se um ponteiro é NULL ou não, como a transformação opcional em [D3D12\_RAYTRACING\_GEOMETRY\_TRIANGLES\_DESC](/pt-BR/reference/graphics/d3d12/structs/d3d12_raytracing_geometry_triangles_desc_public), sem desreferenciá-lo. Em outras palavras, o cálculo dos requisitos de recursos para a estrutura de aceleração não depende dos dados de geometria reais (como as posições dos vértices); ele só pode depender de propriedades gerais, como o número de triângulos, o número de instâncias etc.

*pInfo \[out]*\
Tipo: D3D12\_RAYTRACING\_ACCELERATION\_STRUCTURE\_PREBUILD\_INFO \*

O resultado da consulta.

### Valor retornado

Tipo: void

Nenhum.

## Comentários

A descrição da estrutura de aceleração de entrada é a mesma usada em [BuildRaytracingAccelerationStructure](/pt-BR/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist4/methods/id3d12graphicscommandlist4_buildraytracingaccelerationstructure_public). O resultado desta função permite que o aplicativo forneça a quantidade correta de armazenamento de saída e de armazenamento temporário para **BuildRaytracingAccelerationStructure**, considerando a mesma geometria.

As criações também podem ser feitas com a mesma configuração passada para **GetAccelerationStructurePrebuildInfo** de modo geral, exceto por contagens iguais ou menores para o número de geometrias/instâncias ou o  número de vértices/índices/AABBs em qualquer geometria.  Nesse caso, os requisitos de armazenamento informados com os tamanhos originais passados para **GetRaytracingAccelerationStructurePrebuildInfo** serão válidos; a criação pode, na verdade, consumir menos espaço, mas não mais.  Isso é útil em cenários de aplicativo em que é aceitável ter um armazenamento conservadoramente grande alocado para estruturas de aceleração.

Este método está na interface do dispositivo, e não na lista de comandos, partindo do pressuposto de que os drivers devem ser capazes de calcular os requisitos de recursos para a criação de uma estrutura de aceleração examinando apenas as partes da chamada visíveis à CPU, sem precisar desreferenciar ponteiros para a memória da GPU que contém os dados reais de vértices, de índices etc.

## Requisitos

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

## Consulte também

[ID3D12Device5](/pt-BR/reference/graphics/d3d12/interfaces/id3d12device5/id3d12device5_public)


## Related topics

- [D3D12_RAYTRACING_ACCELERATION_STRUCTURE_PREBUILD_INFO](/pt-BR/reference/graphics/d3d12/structs/d3d12_raytracing_acceleration_structure_prebuild_info_public.md)
- [D3D12_BUILD_RAYTRACING_ACCELERATION_STRUCTURE_INPUTS](/pt-BR/reference/graphics/d3d12/structs/d3d12_build_raytracing_acceleration_structure_inputs_public.md)
- [D3D12_BUILD_RAYTRACING_ACCELERATION_STRUCTURE_DESC](/pt-BR/reference/graphics/d3d12/structs/d3d12_build_raytracing_acceleration_structure_desc_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)