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

# BuildRaytracingAccelerationStructure (XBOX Series 主機)

> 在 GPU 上執行光線追蹤加速結構建置，並可選擇在建置後立即輸出建置後資訊。

在 GPU 上執行光線追蹤加速結構建置，並可選擇在建置後立即輸出建置後資訊。

## 語法

```cpp theme={null}
void BuildRaytracingAccelerationStructure(
    const D3D12_BUILD_RAYTRACING_ACCELERATION_STRUCTURE_DESC  pDesc,
    UINT NumPostbuildInfoDescs,
    const D3D12_RAYTRACING_ACCELERATION_STRUCTURE_POSTBUILD_INFO_DESC  pPostbuildInfoDescs
)
```

### 參數

*pDesc \[in]*\
類型：const D3D12\_BUILD\_RAYTRACING\_ACCELERATION\_STRUCTURE\_DESC \*

要建置之加速結構的描述。

*NumPostbuildInfoDescs \[in]*\
類型：UINT

<i>pPostbuildInfoDescs</i> 陣列的大小。如果不需要建置後資訊，請設為 0。

*pPostbuildInfoDescs \[in]*\
類型：const D3D12\_RAYTRACING\_ACCELERATION\_STRUCTURE\_POSTBUILD\_INFO\_DESC \*

選擇性的描述陣列，描述要產生的建置後資訊，這些資訊說明所建置之加速結構的屬性。

### 傳回值

類型：void

無。

## 備註

此方法可以在圖形或計算命令清單上呼叫，但不能從套件組合呼叫。

您也可以呼叫 [EmitRaytracingAccelerationStructurePostbuildInfo](/zh-TW/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist4/methods/id3d12graphicscommandlist4_emitraytracingaccelerationstructurepostbuildinfo_public)，從已建置的加速結構另外取得建置後資訊。隨建置一併產生建置後資訊的好處是，在建置完成與要求建置後資訊之間不需要屏障，因此可支援應用程式需要立即取得建置後資訊的情境。

## 需求

**標頭:** d3d12\_xs.h\
**程式庫:** d3d12\_xs.lib\
**支援的平台**: XBOX Series 主機

## 另請參閱

[ID3D12GraphicsCommandList4](/zh-TW/reference/graphics/d3d12_xs/interfaces/ID3D12GraphicsCommandList4/id3d12graphicscommandlist4)


## Related topics

- [D3D12_BUILD_RAYTRACING_ACCELERATION_STRUCTURE_TOOLS_VISUALIZATION_HEADER (XBOX Series 主機)](/zh-TW/reference/graphics/d3d12/structs/d3d12_build_raytracing_acceleration_structure_tools_visualization_header_public.md)
- [CopyRaytracingAccelerationStructure (XBOX Series 主機)](/zh-TW/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist4/methods/id3d12graphicscommandlist4_copyraytracingaccelerationstructure_public.md)
- [D3D12_RAYTRACING_ACCELERATION_STRUCTURE_POSTBUILD_INFO_SERIALIZATION_DESC (XBOX Series 主機)](/zh-TW/reference/graphics/d3d12/structs/d3d12_raytracing_acceleration_structure_postbuild_info_serialization_desc_public.md)
- [D3D12_RAYTRACING_ACCELERATION_STRUCTURE_POSTBUILD_INFO_CURRENT_SIZE_DESC (XBOX Series 主機)](/zh-TW/reference/graphics/d3d12/structs/d3d12_raytracing_acceleration_structure_postbuild_info_current_size_desc_public.md)
- [D3D12_RAYTRACING_ACCELERATION_STRUCTURE_POSTBUILD_INFO_COMPACTED_SIZE_DESC (XBOX Series 主機)](/zh-TW/reference/graphics/d3d12/structs/d3d12_raytracing_acceleration_structure_postbuild_info_compacted_size_desc_public.md)