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

# SetShapePcmFormat

> SetShapePcmFormat

# SetShapePcmFormat

設定 PCM 格式。

## 語法

```cpp theme={null}
HRESULT SetShapePcmFormat(  
         SHAPE_PCM_CONTEXT* context,  
         SHAPE_PCM_FORMAT format  
)  
```

### 參數

*context*   \_Inout\_\
類型：[SHAPE\_PCM\_CONTEXT\*](https://docs.xbox.com/zh-TW/reference/audio/shapepcmcontext/structs/shape_pcm_context.md)

指向 [SHAPE\_PCM\_CONTEXT](https://docs.xbox.com/zh-TW/reference/audio/shapepcmcontext/structs/shape_pcm_context.md) 結構的指標。

*format*   \
類型：[SHAPE\_PCM\_FORMAT](https://docs.xbox.com/zh-TW/reference/audio/shapepcmcontext/enums/shape_pcm_format.md)

[SHAPE\_PCM\_FORMAT](https://docs.xbox.com/zh-TW/reference/audio/shapepcmcontext/enums/shape_pcm_format.md) 列舉的其中一個成員。

### 傳回值

類型：HRESULT

HRESULT 成功或錯誤碼。

## 備註

| 函式 | 描述 |
| - | - |
| 非循環線性 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* 設定為 \[0, 254]。使用 SRC 的 `SHAPE_SRC_COMMAND_TYPE_START` 啟動聲部。讓聲部播放到結尾，或選擇性地在迴圈結尾使用 `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

- [ShapePcmContext](https://docs.xbox.com/zh-TW/reference/audio/shapepcmcontext/shapepcmcontext_members.md)
- [SHAPE_PCM_FORMAT](https://docs.xbox.com/zh-TW/reference/audio/shapepcmcontext/enums/shape_pcm_format.md)
- [GetShapePcmFormat](https://docs.xbox.com/zh-TW/reference/audio/shapepcmcontext/functions/getshapepcmformat.md)
- [SetShapePcmMode](https://docs.xbox.com/zh-TW/reference/audio/shapepcmcontext/functions/setshapepcmmode.md)
- [SetShapePcmReadPointer](https://docs.xbox.com/zh-TW/reference/audio/shapepcmcontext/functions/setshapepcmreadpointer.md)