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

# GetRaytracingAccelerationStructurePrebuildInfoX

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

Equivalente a [GetRaytracingAccelerationStructurePrebuildInfo](https://learn.microsoft.com/en-us/windows/win32/api/d3d12/nf-d3d12-id3d12device5-getraytracingaccelerationstructureprebuildinfo), exceto que leva em conta as opções extras aplicadas à estrutura de aceleração quando ela é criada com [BuildRaytracingAccelerationStructureBatched2X](/pt-BR/reference/graphics/d3d12_xs/interfaces/ID3D12GraphicsCommandList6/methods/id3d12graphicscommandlist6_buildraytracingaccelerationstructurebatched2x).

<Note>
  Esta função *deve* ser usada em vez de [GetRaytracingAccelerationStructurePrebuildInfo](https://learn.microsoft.com/en-us/windows/win32/api/d3d12/nf-d3d12-id3d12device5-getraytracingaccelerationstructureprebuildinfo) quando *pExtraOptions* não for nulo.
</Note>

## Sintaxe

```cpp theme={null}
void GetRaytracingAccelerationStructurePrebuildInfoX(  
         const D3D12_BUILD_RAYTRACING_ACCELERATION_STRUCTURE_INPUTS* pInputs,  
         const D3D12XBOX_XDXR_STREAM_DESC* pExtraOptions,  
         D3D12_RAYTRACING_ACCELERATION_STRUCTURE_PREBUILD_INFO* pInfo  
)  
```

### Parâmetros

*pInputs*   \_In\_\
Tipo: D3D12\_BUILD\_RAYTRACING\_ACCELERATION\_STRUCTURE\_INPUTS\*

Descrição da criação da estrutura de aceleração. Essa estrutura é compartilhada com as diversas variantes de `BuildRaytracingAccelerationStructure*`. Para obter mais informações, consulte [D3D12\_BUILD\_RAYTRACING\_ACCELERATION\_STRUCTURE\_INPUTS](https://learn.microsoft.com/en-us/windows/win32/api/d3d12/ns-d3d12-d3d12_build_raytracing_acceleration_structure_inputs).

A implementação tem permissão para examinar todos os parâmetros de CPU nessa estrutura e nas estruturas aninhadas. Ela não pode inspecionar nem 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`, sem desreferenciá-la. Em outras palavras, o cálculo dos requisitos de recursos para a estrutura de aceleração não depende dos dados reais de geometria (como posições de vértices); ele pode depender apenas de propriedades gerais, como o número de triângulos, o número de instâncias etc.

*pExtraOptions*   \_In\_\
Tipo: [D3D12XBOX\_XDXR\_STREAM\_DESC\*](/pt-BR/reference/graphics/d3d12_xs/structs/d3d12xbox_xdxr_stream_desc)

Especifica o tamanho e o local de um blob de dados que pode ser reinterpretado como uma ou mais das seguintes estruturas:

* `D3D12XBOX_BUILD_RAYTRACING_ACCELERATION_STRUCTURE_PARAMS1`
* `D3D12XBOX_BUILD_RAYTRACING_ACCELERATION_STRUCTURE_PARAMS2`
* `D3D12XBOX_BUILD_RAYTRACING_ACCELERATION_STRUCTURE_PARAMS3`

Essas estruturas expõem extensões de recursos do XBOX e controles de nível mais baixo para o processo de criação da estrutura de aceleração.

Consulte o Exemplo 1 em [BuildRaytracingAccelerationStructureBatched2X](/pt-BR/reference/graphics/d3d12_xs/interfaces/ID3D12GraphicsCommandList6/methods/id3d12graphicscommandlist6_buildraytracingaccelerationstructurebatched2x) para ver um exemplo completo de como criar esse blob, consultar os tamanhos de pré-criação e executar uma criação de BVH usando opções extras.

*pInfo*   \_Out\_\
Tipo: D3D12\_RAYTRACING\_ACCELERATION\_STRUCTURE\_PREBUILD\_INFO\*

O resultado da consulta.

### Valor retornado

Tipo: void

## Comentários

Consulte a descrição de `GetRaytracingAccelerationStructurePrebuildInfo` para obter mais informações sobre a finalidade desta função. Esta variante é específica do XBOX e deve ser usada com `BuildRaytracingAccelerationStructureBatched2X` ao fornecer um valor para *pExtraOptions*.

## Requisitos

**Cabeçalho:** d3d12\_xs.h\
**Biblioteca:** d3d12\_xs.lib\
**Plataformas compatíveis**: consoles XBOX Series

## Confira também

[ID3D12Device8](/pt-BR/reference/graphics/d3d12_xs/interfaces/ID3D12Device8/id3d12device8)


## Related topics

- [GetRaytracingAccelerationStructurePrebuildInfo](/reference/graphics/d3d12/interfaces/id3d12device5/methods/id3d12device5_getraytracingaccelerationstructureprebuildinfo_public.md)
- [D3D12_RAYTRACING_ACCELERATION_STRUCTURE_PREBUILD_INFO](/reference/graphics/d3d12/structs/d3d12_raytracing_acceleration_structure_prebuild_info_public.md)