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

# GetShapePcmBufferFull

> GetShapePcmBufferFull

# GetShapePcmBufferFull

取得緩衝區已滿旗標。

## 語法

```cpp theme={null}
bool GetShapePcmBufferFull(  
         const SHAPE_PCM_CONTEXT* context  
)  
```

### 參數

*context*   \_In\_\
類型：[SHAPE\_PCM\_CONTEXT\*](/zh-TW/reference/audio/shapepcmcontext/structs/shape_pcm_context)

指向 [SHAPE\_PCM\_CONTEXT](/zh-TW/reference/audio/shapepcmcontext/structs/shape_pcm_context) 結構的指標。

### 傳回值

類型：bool

指定緩衝區已滿旗標。

## 備註

取樣率轉換器 (SRC) 區塊會從系統記憶體讀取 16 位元、24 位元或 32 位元定點，或 32 位元浮點脈衝碼調變 (PCM) 資料，並執行以整數為基礎的取樣率轉換。輸出資料會寫入混音緩衝區。對於輸入資料，SRC 區塊可以採用 XMA 硬體解碼器的輸出，或由軟體維護的資料。SRC 區塊與 XMA 解碼器緊密整合，因此 SRC 區塊不需要讀取主記憶體，就能判斷 XMA 解碼緩衝區是否有足夠的已解碼 PCM 資料樣本。

SRC 處理通常用於樂器模擬、將輸入樣本轉換為比來源低或高一個八度，或是都卜勒效應等效果。

SRC 會以單聲道或立體聲模式運作。PCM 資料會從記憶體讀取，並轉換成通用的 24 位元定點格式以進行取樣率轉換。輸出會依模式寫入一個或兩個混音緩衝區。立體聲資料在記憶體中儲存為交錯的 16 位元資料串流，左聲道位於每個 32 位元字組的最低有效 16 位元，右聲道位於最高有效 16 位元。在立體聲模式中，PCM 資料會在讀取的同時解除交錯。左聲道資料 (偶數編號樣本) 會經過處理並輸出至一個混音緩衝區，右聲道資料 (奇數編號樣本) 則會寫入第二個混音緩衝區。

## 需求

**標頭：** shapepcmcontext.h

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

## 另請參閱

[ACP 概觀](/zh-TW/build/console-features/audio/overviews/acp-overview)\
[Shape 概觀](/zh-TW/build/console-features/audio/overviews/shape-overview)\
[shapepcmcontext](/zh-TW/reference/audio/shapepcmcontext/shapepcmcontext_members)


## Related topics

- [ShapePcmContext](/zh-TW/reference/audio/shapepcmcontext/shapepcmcontext_members.md)
- [SetShapePcmBufferFull](/zh-TW/reference/audio/shapepcmcontext/functions/setshapepcmbufferfull.md)
- [GetShapePcmBufferLength](/zh-TW/reference/audio/shapepcmcontext/functions/getshapepcmbufferlength.md)
- [GetShapePcmAudioBuffer](/zh-TW/reference/audio/shapepcmcontext/functions/getshapepcmaudiobuffer.md)
- [GetShapeDmaBufferFull](/zh-TW/reference/audio/shapedmacontext/functions/getshapedmabufferfull.md)