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

# SHAPE_SRC_CONTEXT

> SHAPE_SRC_CONTEXT

# SHAPE\_SRC\_CONTEXT

采样率转换器 (SRC) 上下文。

## 语法

```cpp theme={null}
typedef struct SHAPE_SRC_CONTEXT {  
    UINT32 timestamp : 21;  
    UINT32 blocksToSkip : 2;  
    UINT32 internalSaturate : 1;  
    UINT32 mixBufPeakMag : 4;  
    UINT32 peakMag : 4;  
    UINT32 samplingIncrement : 21;  
    UINT32 reserved0 : 1;  
    UINT32 cmd : 2;  
    UINT32 mixBufPeakMag2 : 4;  
    UINT32 peakMag2 : 4;  
    UINT32 sampleCount : 32;  
    UINT32 samplePointer : 25;  
    UINT32 reserved1 : 7;  
    UINT32 samplingIncrementTarget : 21;  
    UINT32 reserved2 : 11;  
    UINT32 reserved[3];  
};  
```

### 成员

*timestamp*\
Type: UINT32

Read:上下文处理完成的时间戳。

*blocksToSkip*\
Type: UINT32

Write:启动时要跳过的 XMA 块数。

*internalSaturate*\
Type: UINT32

Read:如果 SRC 饱和,则为 1;否则为 0。

*mixBufPeakMag*\
Type: UINT32

Read:左通道(或单声道)输出混音缓冲区的峰值幅度。

*peakMag*\
Type: UINT32

Read:左通道(或单声道)的峰值幅度。

*samplingIncrement*\
Type: UINT32

Read/Write:采样增量的起始值。

*reserved0*\
Type: UINT32

保留。

*cmd*\
Type: UINT32

Read/Write:[SHAPE\_SRC\_COMMAND\_TYPE](/reference/audio/shapesrccontext/enums/shape_src_command_type) 枚举的成员。

*mixBufPeakMag2*\
Type: UINT32

Read:右通道(或第二通道)输出混音缓冲区的峰值幅度。

*peakMag2*\
Type: UINT32

Read:右通道(或第二通道)的峰值幅度。

*sampleCount*\
Type: UINT32

Read:自播放开始以来处理的音频采样数。

*samplePointer*\
Type: UINT32

Read/Write:指向当前 XMA/PCM 输入采样的指针。

*reserved1*\
Type: UINT32

保留。

*samplingIncrementTarget*\
Type: UINT32

Read/Write:采样增量的目标值或结束值。

*reserved2*\
Type: UINT32

保留。

*reserved*\
Type: UINT32\[3]

保留。

## 备注

此结构包含 SRC 块的上下文。SRC 执行采样率转换和音调变换。

标记为 **Read** 的成员由音频控制处理器 (ACP) 库写入,应用程序应仅读取这些成员。标记为 **Write** 的成员由应用程序设置,ACP 库不会更改这些成员。标记为 **Read/Write** 的成员由应用程序设置,但可以由 ACP 库更改。有关 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 主机

## 概念文档

* [ACP overview](/build/console-features/audio/overviews/acp-overview)

## 另请参阅

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


## Related topics

- [ShapeSrcContext](/zh-CN/reference/audio/shapesrccontext/shapesrccontext_members.md)
- [GetShapeSrcPitch](/zh-CN/reference/audio/shapesrccontext/functions/getshapesrcpitch.md)
- [GetShapeSrcTimestamp](/zh-CN/reference/audio/shapesrccontext/functions/getshapesrctimestamp.md)
- [SetShapeSrcCommand](/zh-CN/reference/audio/shapesrccontext/functions/shapesrccontext_setshapesrccommand.md)
- [SetShapeSrcPitch](/zh-CN/reference/audio/shapesrccontext/functions/setshapesrcpitch.md)