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

# D3D12_RAYTRACING_ACCELERATION_STRUCTURE_PREBUILD_INFO

> 表示有关光线追踪加速结构的预构建信息。通过调用来获取此结构的实例。

表示有关光线追踪加速结构的预构建信息。通过调用 [GetRaytracingAccelerationStructurePrebuildInfo](/reference/graphics/d3d12/interfaces/id3d12device5/methods/id3d12device5_getraytracingaccelerationstructureprebuildinfo_public) 获取此结构的实例。

## 语法

```cpp theme={null}
typedef struct D3D12_RAYTRACING_ACCELERATION_STRUCTURE_PREBUILD_INFO
{
    UINT64 ResultDataMaxSizeInBytes;
    UINT64 ScratchDataSizeInBytes;
    UINT64 UpdateScratchDataSizeInBytes;
} D3D12_RAYTRACING_ACCELERATION_STRUCTURE_PREBUILD_INFO
```

### 成员

*ResultDataMaxSizeInBytes*\
类型：UINT64

保存基于指定输入的加速结构构建结果所需的大小。

*ScratchDataSizeInBytes*\
类型：UINT64

基于指定输入的加速结构构建期间在 GPU 上所需的暂存存储。

#### UpdateScratchDataSizeInBytes

基于指定输入的加速结构更新期间在 GPU 上所需的暂存存储。这只需为原始加速结构构建调用，并定义除初始构建外每次加速结构更新的暂存存储要求。

如果在调用 [GetRaytracingAccelerationStructurePrebuildInfo](/reference/graphics/d3d12/interfaces/id3d12device5/methods/id3d12device5_getraytracingaccelerationstructureprebuildinfo_public) 时未指定 [D3D12\_RAYTRACING\_ACCELERATION\_STRUCTURE\_BUILD\_FLAG\_ALLOW\_UPDATE](/reference/graphics/d3d12/enums/d3d12_raytracing_acceleration_structure_build_flags_public) 标志，则此字段的返回值为 0。

*UpdateScratchDataSizeInBytes*\
类型：UINT64

## 要求

**头文件：** d3d12\_xs.h\
**库：** d3d12\_xs.lib\
**支持的平台**：XBOX Series 主机