> ## Documentation Index
> Fetch the complete documentation index at: https://docs.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](https://docs.xbox.com/zh-TW/reference/audio/shapesrccontext/enums/shape_src_command_type.md) 列舉。 |
| 無限循環線性 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` 立即停止。 |

輸入樣本格式：\\

![顯示四種支援的 PCM 輸入樣本格式各自位元配置的圖表。](https://mintcdn.com/microsoft-4404708b/gzrdvT5kpqAXKEQt/images/gdk/reference/pcm_format.png?fit=max\&auto=format\&n=gzrdvT5kpqAXKEQt\&q=85\&s=58f4b6bb7fadd542a8c9a337cd729ba2)

## 需求

**標頭：** shapepcmcontext.h

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

## 另請參閱

[ACP 概觀](https://docs.xbox.com/zh-TW/build/console-features/audio/overviews/acp-overview.md)\
[Shape 概觀](https://docs.xbox.com/zh-TW/build/console-features/audio/overviews/shape-overview.md)\
[shapepcmcontext](https://docs.xbox.com/zh-TW/reference/audio/shapepcmcontext/shapepcmcontext_members.md)


## Related topics

- [GetShapePcmFormat](https://docs.xbox.com/zh-TW/reference/audio/shapepcmcontext/functions/getshapepcmformat.md)
- [SetShapePcmFormat](https://docs.xbox.com/zh-TW/reference/audio/shapepcmcontext/functions/setshapepcmformat.md)
- [ShapePcmContext](https://docs.xbox.com/zh-TW/reference/audio/shapepcmcontext/shapepcmcontext_members.md)
- [SHAPE_PCM_CONTEXT](https://docs.xbox.com/zh-TW/reference/audio/shapepcmcontext/structs/shape_pcm_context.md)
- [SHAPE_PCM_MODE](https://docs.xbox.com/zh-TW/reference/audio/shapepcmcontext/enums/shape_pcm_mode.md)