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

> SHAPE_PCM_FORMAT

# SHAPE\_PCM\_FORMAT

指定 PCM 格式的列舉。

## 語法

```cpp theme={null}
enum SHAPE_PCM_FORMAT    
{  
    SHAPE_PCM_FORMAT_16_BIT_MONO,  
    SHAPE_PCM_FORMAT_16_BIT_STEREO,  
    SHAPE_PCM_FORMAT_32_BIT_MONO,  
    SHAPE_PCM_FORMAT_32_BIT_FLOAT  
}  
```

## 常數

| 常數 | 描述 |
| - | - |
| SHAPE\_PCM\_FORMAT\_16\_BIT\_MONO | 16 位元單聲道。緩衝區大小為 `numSamples * sizeof(INT16)`。 |
| SHAPE\_PCM\_FORMAT\_16\_BIT\_STEREO | 16 位元立體聲。對於讀取和寫入指標，會視為單一 32 位元樣本。緩衝區大小為 `numSamples * 2 * sizeof(INT16)`。 |
| SHAPE\_PCM\_FORMAT\_32\_BIT\_MONO | 24 位元或 32 位元整數單聲道。可以是靠左對齊的 24 位元，或遮罩掉較低 8 位元的 32 位元。緩衝區大小為 `numSamples * sizeof(INT32)`。 |
| SHAPE\_PCM\_FORMAT\_32\_BIT\_FLOAT | 32 位元浮點單聲道。緩衝區大小為 `numSamples * sizeof(FLOAT32)`。 |

## 備註

| 函式 | 描述 |
| - | - |
| 非循環線性 PCM | 使用取樣率轉換器 (SRC) 的 `SHAPE_SRC_COMMAND_TYPE_START` 常數啟動聲部。讓聲部播放到結尾，或選擇性地使用 `SHAPE_SRC_COMMAND_TYPE_STOP_IMMEDIATE` 常數在結尾之前停止。如需詳細資訊，請參閱 [SHAPE\_SRC\_COMMAND\_TYPE](/zh-TW/reference/audio/shapesrccontext/enums/shape_src_command_type) 列舉。 |
| 無限循環線性 PCM | 將脈衝碼調變 (PCM) 內容迴圈計數 *loopCount* 設定為 `SHAPE_PCM_INFINITE_LOOP_COUNT` 常數。使用 SRC 的 `SHAPE_SRC_COMMAND_TYPE_START` 啟動聲部。讓聲部持續播放直到您要停止為止，可以在迴圈結尾使用 `SHAPE_SRC_COMMAND_TYPE_STOP_END` 並讓聲部播放完畢，或使用 `SHAPE_SRC_COMMAND_TYPE_STOP_IMMEDIATE` 立即停止。 |
| 有限循環線性 PCM | 將 PCM 內容迴圈計數 *loopCount* 設定為結尾，或選擇性地在迴圈結尾使用 `SHAPE_SRC_COMMAND_TYPE_STOP_END` 停止並讓聲部播放完畢，或使用 `SHAPE_SRC_COMMAND_TYPE_STOP_IMMEDIATE` 立即停止。 |
| 循環 PCM | 使用 SRC 的 `SHAPE_SRC_COMMAND_TYPE_START` 啟動聲部。持續串流資料並更新 PCM 內容寫入指標，直到您要停止為止。使用 `SHAPE_SRC_COMMAND_TYPE_STOP_END` 讓 SRC 播放到目前的 PCM 寫入指標 `loopStartWritePointer`，或使用 `SHAPE_SRC_COMMAND_TYPE_STOP_IMMEDIATE` 立即停止。 |

輸入樣本格式：\\

<img src="https://mintcdn.com/microsoft-4404708b/gzrdvT5kpqAXKEQt/images/gdk/reference/pcm_format.png?fit=max&auto=format&n=gzrdvT5kpqAXKEQt&q=85&s=58f4b6bb7fadd542a8c9a337cd729ba2" alt="顯示四種支援的 PCM 輸入樣本格式各自位元配置的圖表。" width="740" height="357" data-path="images/gdk/reference/pcm_format.png" />

## 需求

**標頭：** 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

- [SHAPE_PCM_FORMAT](/zh-CN/reference/audio/shapepcmcontext/enums/shape_pcm_format.md)
- [GetShapePcmFormat](/reference/audio/shapepcmcontext/functions/getshapepcmformat.md)
- [SetShapePcmFormat](/reference/audio/shapepcmcontext/functions/setshapepcmformat.md)