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

# ShapeSrcSamplingIncrementToPitch

> ShapeSrcSamplingIncrementToPitch

# ShapeSrcSamplingIncrementToPitch

将采样率转换器 (SRC) 的采样增量转换为音调值。

## 语法

```cpp theme={null}
float ShapeSrcSamplingIncrementToPitch(  
         UINT32 val  
)  
```

### 参数

*val*   \
Type: UINT32

采样增量。

### 返回值

Type: float

音调。

## 备注

音调值的范围为 0.0625 到 3.99。(但是,不会检查 *val* 参数以确保返回值处于该范围内。)

若要将音调值转换为采样增量,请使用 [PitchToShapeSrcSamplingIncrement](/reference/audio/shapesrccontext/functions/pitchtoshapesrcsamplingincrement)。

有关 SRC 的详细信息,请参阅 [Overview of SHAPE](/build/console-features/audio/overviews/shape-overview) 中的 [Sample Rate Convertor (SRC) block](/build/console-features/audio/overviews/shape-overview#ID4EOE)。

## 要求

**头文件:** shapesrccontext.h

**支持的平台:** XBOX One 系列主机和 XBOX Series 主机

## 另请参阅

[ShapeSrcContext](/reference/audio/shapesrccontext/shapesrccontext_members)


## Related topics

- [PitchToShapeSrcSamplingIncrement](/zh-CN/reference/audio/shapesrccontext/functions/pitchtoshapesrcsamplingincrement.md)
- [ShapeSrcContext](/zh-CN/reference/audio/shapesrccontext/shapesrccontext_members.md)
- [ACP_COMMAND_UPDATE_SRC_CONTEXT_ENTRY](/zh-CN/reference/audio/acphal/structs/acp_command_update_src_context_entry.md)
- [ACP_COMMAND_UPDATE_SRC_CONTEXT](/zh-CN/reference/audio/acphal/structs/acp_command_update_src_context.md)
- [SHAPE_SRC_CONTEXT](/zh-CN/reference/audio/shapesrccontext/structs/shape_src_context.md)