> ## 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*\
類型：UINT32

讀取：內容處理完成的時間戳記。

*blocksToSkip*\
類型：UINT32

寫入：開始時要略過的 XMA 區塊數目。

*internalSaturate*\
類型：UINT32

讀取：如果 SRC 已飽和則為 1；否則為 0。

*mixBufPeakMag*\
類型：UINT32

讀取：左聲道 (或單聲道) 輸出混音緩衝區的峰值量值。

*peakMag*\
類型：UINT32

讀取：左聲道 (或單聲道) 的峰值量值。

*samplingIncrement*\
類型：UINT32

讀取/寫入：取樣增量的起始值。

*reserved0*\
類型：UINT32

保留。

*cmd*\
類型：UINT32

讀取/寫入：[SHAPE\_SRC\_COMMAND\_TYPE](/zh-TW/reference/audio/shapesrccontext/enums/shape_src_command_type) 列舉的成員。

*mixBufPeakMag2*\
類型：UINT32

讀取：右聲道 (或第二聲道) 輸出混音緩衝區的峰值量值。

*peakMag2*\
類型：UINT32

讀取：右聲道 (或第二聲道) 的峰值量值。

*sampleCount*\
類型：UINT32

讀取：自播放開始以來已處理的音訊樣本數目。

*samplePointer*\
類型：UINT32

讀取/寫入：指向目前 XMA/PCM 輸入樣本的指標。

*reserved1*\
類型：UINT32

保留。

*samplingIncrementTarget*\
類型：UINT32

讀取/寫入：取樣增量的目標值或結束值。

*reserved2*\
類型：UINT32

保留。

*reserved*\
類型：UINT32\[3]

保留。

## 備註

此結構包含 SRC 區塊的內容。SRC 會執行取樣率轉換和音高偏移。

標示為 **讀取** 的成員由音訊控制處理器 (ACP) 程式庫寫入，您的應用程式應該只讀取這些成員。標示為 **寫入** 的成員由您的應用程式設定，且不會被 ACP 程式庫變更。標示為 **讀取/寫入** 的成員由您的應用程式設定，但可能會被 ACP 程式庫變更。如需 SRC 的詳細資訊，請參閱 [SHAPE 概觀](/zh-TW/build/console-features/audio/overviews/shape-overview)中的[取樣率轉換器 (SRC) 區塊](/zh-TW/build/console-features/audio/overviews/shape-overview#ID4EOE)。

## 需求

**標頭：** shapesrccontext.h

**支援的平台：** XBOX One 系列主機和 XBOX Series 主機

## 概念文件

* [ACP 概觀](/zh-TW/build/console-features/audio/overviews/acp-overview)

## 另請參閱

[ShapeSrcContext](/zh-TW/reference/audio/shapesrccontext/shapesrccontext_members)


## Related topics

- [SHAPE_SRC_CONTEXT](/reference/audio/shapesrccontext/structs/shape_src_context.md)
- [ShapeSrcContext](/reference/audio/shapesrccontext/shapesrccontext_members.md)