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

# SetShapePcmLoopStartOrWritePointer

> SetShapePcmLoopStartOrWritePointer

# SetShapePcmLoopStartOrWritePointer

設定線性緩衝區的迴圈起點，或循環緩衝區的寫入指標。

## 語法

```cpp theme={null}
HRESULT SetShapePcmLoopStartOrWritePointer(  
         SHAPE_PCM_CONTEXT* context,  
         UINT32 loopStartOrWritePointerInSamples  
)  
```

### 參數

*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) 結構的指標。

*loopStartOrWritePointerInSamples*   \
類型：UINT32

指定迴圈起點或寫入指標。

### 傳回值

類型：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` 立即停止。 |

## 需求

**標頭：** 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)
- [GetShapePcmLoopStartOrWritePointer](/zh-TW/reference/audio/shapepcmcontext/functions/getshapepcmloopstartorwritepointer.md)
- [SetShapePcmLoopCount](/zh-TW/reference/audio/shapepcmcontext/functions/setshapepcmloopcount.md)
- [SetShapePcmLoopEnd](/zh-TW/reference/audio/shapepcmcontext/functions/setshapepcmloopend.md)
- [SHAPE_PCM_CONTEXT](/zh-TW/reference/audio/shapepcmcontext/structs/shape_pcm_context.md)