Skip to main content
Equivalente a GetRaytracingAccelerationStructurePrebuildInfo, exceto que leva em conta as opções extras aplicadas à estrutura de aceleração quando ela é criada com BuildRaytracingAccelerationStructureBatched2X.
Esta função deve ser usada em vez de GetRaytracingAccelerationStructurePrebuildInfo quando pExtraOptions não for nulo.

​
Sintaxe

​
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. 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* 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 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
Last modified on October 6, 2026