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

# SetShapePcmFormat

> SetShapePcmFormat

# SetShapePcmFormat

設定 PCM 格式。

## 語法

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

### 參數

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

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

*format*   \
類型：[SHAPE\_PCM\_FORMAT](/zh-TW/reference/audio/shapepcmcontext/enums/shape_pcm_format)

[SHAPE\_PCM\_FORMAT](/zh-TW/reference/audio/shapepcmcontext/enums/shape_pcm_format) 列舉的其中一個成員。

### 傳回值

類型：HRESULT

HRESULT 成功或錯誤碼。

## 備註

| 函式 | 描述 |
| - | - |
| 非循環線性 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* 設定為 \[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` 立即停止。 |

輸入樣本格式：\\

<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

- [ShapePcmContext](/zh-TW/reference/audio/shapepcmcontext/shapepcmcontext_members.md)
- [SHAPE_PCM_FORMAT](/zh-TW/reference/audio/shapepcmcontext/enums/shape_pcm_format.md)
- [GetShapePcmFormat](/zh-TW/reference/audio/shapepcmcontext/functions/getshapepcmformat.md)
- [SetShapePcmMode](/zh-TW/reference/audio/shapepcmcontext/functions/setshapepcmmode.md)
- [SetShapePcmBufferLength](/zh-TW/reference/audio/shapepcmcontext/functions/setshapepcmbufferlength.md)