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

# GetShapePcmReadPointer

> GetShapePcmReadPointer

# GetShapePcmReadPointer

読み取りポインターを取得します。

## 構文

```cpp theme={null}
UINT32 GetShapePcmReadPointer(  
         const SHAPE_PCM_CONTEXT* context  
)  
```

### パラメーター

*context*   \_In\_\
型: [SHAPE\_PCM\_CONTEXT\*](/reference/audio/shapepcmcontext/structs/shape_pcm_context)

[SHAPE\_PCM\_CONTEXT](/reference/audio/shapepcmcontext/structs/shape_pcm_context) 構造体へのポインター。

### 戻り値

型: UINT32

読み取りポインターをサンプル単位で指定します。このポインターは、2 つの 16 ビットステレオサンプルを単一の 32 ビットサンプルとして扱います。

## 解説

Direct Memory Access (DMA) コマンドがブロックされるのを防ぐには、オーディオバッファーを十分に大きく確保し、バッファーサイズに応じた一定の間隔でデータをストリーミングするようにします。たとえば、1 度に 4 つのハードウェアフレームをストリーミングする場合、ハードウェアがタイトルの読み取りポインターより先に書き込めるよう、その倍数のフレーム (少なくとも 2 倍のダブルバッファリングで 8 フレーム) をバッファーに保持してください。あるいは、次のフローグラフを送信する前にバッファーを空にすることを強制する方法もあります (消費し、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](/reference/audio/shapesrccontext/enums/shape_src_command_type) 列挙型を参照してください。

## 要件

**ヘッダー:** shapepcmcontext.h

**サポート対象プラットフォーム:** XBOX One ファミリー本体および XBOX Series 本体

## 関連項目

[ACP の概要](/build/console-features/audio/overviews/acp-overview)\
[Shape の概要](/build/console-features/audio/overviews/shape-overview)\
[shapepcmcontext](/reference/audio/shapepcmcontext/shapepcmcontext_members)


## Related topics

- [ShapePcmContext](/ja-jp/reference/audio/shapepcmcontext/shapepcmcontext_members.md)
- [SetShapePcmReadPointer](/ja-jp/reference/audio/shapepcmcontext/functions/setshapepcmreadpointer.md)
- [GetShapePcmLoopStartOrWritePointer](/ja-jp/reference/audio/shapepcmcontext/functions/getshapepcmloopstartorwritepointer.md)
- [GetShapeDmaReadPointer](/ja-jp/reference/audio/shapedmacontext/functions/getshapedmareadpointer.md)
- [SHAPE_PCM_CONTEXT](/ja-jp/reference/audio/shapepcmcontext/structs/shape_pcm_context.md)