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

# SetShapePcmReadPointer

> SetShapePcmReadPointer

# SetShapePcmReadPointer

設定讀取指標。

## 語法

```cpp theme={null}
HRESULT SetShapePcmReadPointer(  
         SHAPE_PCM_CONTEXT* context,  
         UINT32 readPointerInSamples  
)  
```

### 參數

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

*readPointerInSamples*   \
類型：UINT32

以樣本為單位的讀取指標。此指標會將兩個 16 位元立體聲樣本視為單一 32 位元樣本。

### 傳回值

類型：HRESULT

HRESULT 成功或錯誤碼。

## 備註

您可以確保音訊緩衝區夠大，並以與緩衝區大小相關的固定間隔串流資料，來防止 Direct Memory Access (DMA) 命令遭到封鎖。例如，如果您一次串流四個硬體框架，請確保緩衝區中有這些框架的某個倍數 (至少為雙重緩衝的八個框架)，讓硬體可以在遊戲的讀取指標之前寫入。或者，您也可以強制在提交下一個流程圖之前清空緩衝區 (取用、更新 DMA 讀取指標，然後提交流程圖)。

使用 SRC 的 `SHAPE_SRC_COMMAND_TYPE_START` 常數啟動聲部。持續串流資料並更新 PCM 內容寫入指標，直到您要停止為止。使用 `SHAPE_SRC_COMMAND_TYPE_STOP_END` 常數讓 SRC 播放到目前的 PCM 寫入指標 `loopStartWritePointer`，或使用 `SHAPE_SRC_COMMAND_TYPE_STOP_IMMEDIATE` 立即停止。如需詳細資訊，請參閱 [SHAPE\_SRC\_COMMAND\_TYPE](/zh-TW/reference/audio/shapesrccontext/enums/shape_src_command_type) 列舉。

## 需求

**標頭：** 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)
- [GetShapePcmReadPointer](/zh-TW/reference/audio/shapepcmcontext/functions/getshapepcmreadpointer.md)
- [SetShapePcmLoopStartOrWritePointer](/zh-TW/reference/audio/shapepcmcontext/functions/setshapepcmloopstartorwritepointer.md)
- [SetShapeDmaReadPointer](/zh-TW/reference/audio/shapedmacontext/functions/setshapedmareadpointer.md)
- [SHAPE_PCM_CONTEXT](/zh-TW/reference/audio/shapepcmcontext/structs/shape_pcm_context.md)