> ## 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_PIPELINE_CONFIG1 (XBOX Series consoles)

> 表示带有标志的光线追踪管线配置的状态子对象。

表示带有标志的光线追踪管线配置的状态子对象。

**D3D12\_RAYTRACING\_PIPELINE\_CONFIG1** 需要 Tier 1.1 光线追踪支持（请参阅 [D3D12\_RAYTRACING\_TIER](/reference/graphics/d3d12/enums/d3d12_raytracing_tier_public)）。

## 语法

```cpp theme={null}
typedef struct D3D12_RAYTRACING_PIPELINE_CONFIG1
{
    UINT MaxTraceRecursionDepth;
    D3D12_RAYTRACING_PIPELINE_FLAGS Flags;
} D3D12_RAYTRACING_PIPELINE_CONFIG1
```

### 成员

*MaxTraceRecursionDepth*\
类型：UINT

光线追踪管线的光线递归限制。必须在 0 到 31 的范围内。在最大递归深度以下，着色器调用（例如最近命中或未命中着色器）可以调用 **TraceRay** 任意次数。达到最大递归深度时，**TraceRay** 调用会导致设备进入被移除状态。

*Flags*\
类型：D3D12\_RAYTRACING\_PIPELINE\_FLAGS

光线追踪管线的配置标志。

## 备注

光线追踪管线需要一个光线追踪管线配置。如果存在多个管线配置，则它们的内容必须全部匹配。但这种重复没有好处。例如，为每个集合定义一次不会帮助驱动程序在创建光线追踪管线之前进行早期着色器编译。这与 [D3D12\_RAYTRACING\_SHADER\_CONFIG](/reference/graphics/d3d12/structs/d3d12_raytracing_shader_config_public) 不同，后者*确实*受益于每集合重复。

## 要求

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

## 另请参阅


## Related topics

- [D3D12_RAYTRACING_PIPELINE_CONFIG (XBOX Series consoles)](/zh-CN/reference/graphics/d3d12/structs/d3d12_raytracing_pipeline_config_public.md)
- [D3D12_RAYTRACING_PIPELINE_FLAGS (XBOX Series 主机)](/zh-CN/reference/graphics/d3d12/enums/d3d12_raytracing_pipeline_flags_public.md)
- [D3D12_RAYTRACING_GEOMETRY_DESC (XBOX Series consoles)](/zh-CN/reference/graphics/d3d12/structs/d3d12_raytracing_geometry_desc_public.md)
- [D3D12_RAYTRACING_AABB (XBOX Series consoles)](/zh-CN/reference/graphics/d3d12/structs/d3d12_raytracing_aabb_public.md)
- [D3D12_RAYTRACING_SHADER_CONFIG (XBOX Series consoles)](/zh-CN/reference/graphics/d3d12/structs/d3d12_raytracing_shader_config_public.md)