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

# PitchToShapeSrcSamplingIncrement

> PitchToShapeSrcSamplingIncrement

# PitchToShapeSrcSamplingIncrement

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

## 语法

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

### 参数

*val*   \
类型：float

音调。

### 返回值

类型：UINT32

采样增量。

## 备注

音调值的取值范围为 0.0625-3.99。（但是，超出此范围的值不会返回错误。）

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

有关 SRC 的更多信息，请参阅 [SHAPE 概述](/build/console-features/audio/overviews/shape-overview)中的[采样率转换器 (SRC) 块](/build/console-features/audio/overviews/shape-overview#ID4EOE)。

## 要求

**标头：** shapesrccontext.h

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

## 另请参阅

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


## Related topics

- [ShapeSrcSamplingIncrementToPitch](/zh-CN/reference/audio/shapesrccontext/functions/shapesrcsamplingincrementtopitch.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)